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配 大 容量 DVD 光盘 ， 提 供 配套 的 多 媒体 教学 视频 和 源 代码 


针对 Android 2.2 与 2.3 版 本 ， 并 涉及 最 新 的 4.0 技 术 
52 个 实例 、2 个 案例 ， 详 解 Android 开 发 的 整个 流程 
书 中 的 每 一 个 知识 点 都 配合 典型 示例 进行 讲解 

对 关键 源 代码 进行 了 详细 注释 ， 便 于 理解 
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内 容 简 介 


本 书 通 过 开发 实例 和 项 目 案例 , 详细 地 介绍 了 Android 应 用 开发 的 主要 技术 。 书 中 的 每 一 个 知识 点 都 
通过 常用 示例 进行 通俗 易 懂 的 讲解 ， 便 于 读者 快速 掌握 Android 应 用 开发 的 知识 ， 并 能 够 快速 地 开发 出 
Android 应 用 程序 。 本 书 配 带 1 张 光 盘 ， 收 录 了 本 书 重 点 内 容 的 教学 视频 和 本 书 涉 及 的 所 有 源 代码 。 

本 书 分 为 11 章 ， 从 Android 的 基本 知识 讲 起 ， 通 过 实例 逐步 深入 讲解 了 Android 的 界面 布局 、 程 序 
特性 、 数 据 存储 、 网 络 通信 、 多 媒体 、 手 机 短信 通话 、 传 感 器 和 GPS 等 应 用 开发 的 基本 知识 ， 然 后 介绍 
了 Android NDK 开发 等 拓展 知识 ， 最 后 介绍 了 文件 管理 器 、 微 博客 户 端 综合 案例 ， 使 读者 综合 应 用 所 学 
知识 ， 提 高 实战 开发 水 平 。 

本 书 适合 有 一 定 Java 基础 的 Android 新 手 和 移动 开发 新 入 行 的 人 员 阅 读 。 对 于 有 一 定 基础 的 读者 ， 
可 通过 本 书 进一步 理解 Android 应 用 开发 的 各 个 重点 知识 和 概念 ; 对 于 大 、 中 专 院 校 的 学 生 和 培训 班 的 学 
员 ， 本 书 不 失 为 一 本 好 教材 。 
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了 中 


前 


Android 是 一 种 以 Linux 为 基础 的 开放 源码 的 操作 系统 , 主要 用 于 手机 、 平板 电脑 等 便 
携 设 备 的 开发 。 它 由 谷歌 公司 组 建 、 开 放手 持 设备 联盟 开发 和 领导 。 自 从 谷歌 公司 推出 
Android 系统 后 ， 便 一 直 受 到 全 球 用 户 及 开发 者 的 关注 。 截 止 2011 年 8 月 ，Android 操作 
系统 在 全 球 智能 手机 操作 系统 的 市 场 份额 已 达 48%， 成 为 全 球 第 一 大 智能 手机 操作 系统 。 

截止 2011 年 10 月 ，Android 官方 电子 市 场 上 拥有 超过 30 万 个 认证 的 应 用 程序 ， 其 下 
载 量 也 在 2011 年 12 月 达到 100 亿 次 。 目 前 ， 国 内 外 软件 行业 已 经 出 现 了 Android 人 才 藻 ， 
未 来 人 才 需 求 缺 口 将 达 数 以 百 万 。 作 为 一 名 软件 开发 人 员 一 定 要 把 握 这 一 机 会 ， 加 入 
Android 应 用 程序 的 开发 ， 成 为 炙手可热 的 Android 开发 工程 师 。 

对 于 Android 应 用 开发 ， 其 支持 使 用 Java 作为 编程 语言 来 开发 应 用 程序 。 在 Android 
平台 上 进行 开发 ， 对 Java 语言 提供 了 如 下 的 支持 和 自身 特性 : 

口 对 JDK 的 高 级 特性 均 支 持 ， 其 中 包括 了 Java 的 反射 机 制 、JNI 等 。 相 对 而 言 ， 对 

于 OpenGL 和 SQLite 的 支持 比较 强大 ， 但 对 AWT 和 JDBC 这 些 东西 都 不 支持 。 

口 在 XML 解析 上 ， 兼 窑 DOM、XmlPull 和 SAX。 

口 对 于 HTTP 处 理 方面 ,提供 了 轻 量 级 的 Http 处 理 类 , 以 及 更 完善 的 Apache 库 支持 。 

口 音 视频 方面 ，Android 使 用 了 OpenCore 库 实现 比较 强大 的 功能 。 

要 进行 Android 应 用 程序 开发 ， 除 了 了 解 Android 对 Java 语言 的 支持 情况 外 ， 还 需要 
掌握 Android 应 用 程序 具有 的 特性 组 件 Activity、Intent、Service、Receiver， 及 其 SDK 中 
提供 的 丰富 的 类 与 方法 。 

本 书 通过 展现 丰富 的 Android 应 用 开发 实例 ， 让 Android 入 门 新 手 能 在 较 短 的 时 间 内 
了 解 并 掌握 Android 应 用 程序 开发 的 基本 思维 和 基础 知识 。 本 书 讲解 时 从 实际 出 发 ， 从 实 
际 的 Android 应 用 开发 中 进行 讲解 。 语 言 上 力求 幽默 直 白 、 轻 松 活泼 ， 避 免 云 山 雾 罩 、 星 
深 难 懂 。 讲 解 形式 上 图 文 并 诚 、 由 浅 入 深 、 抽 丝 剥 草 。 通 过 阅读 本 书 ， 读 者 会 少 走 很 多 弯 
路 ， 快 速 进入 Android 应 用 开发 的 大 门 。 


本 书 特色 





1. 提供 配套 的 多 媒体 教学 视频 


本 书 中 的 重点 内 容 都 录制 了 配套 的 多 媒体 教学 视频 ， 以 帮助 读者 更 加 直观 而 高 效 地 学 
习 ， 从 而 达到 事半功倍 的 效果 。 


2. 内 容 丰富 、 全 面 


本 书 涵 盖 了 Android 开发 从 界面 布局 、 程 序 特性 、 数 据 存储 、 网 络 通信 、 多 媒体 及 手 
机 短信 通话 及 传感器 等 技术 ， 还 介绍 了 Android NDK 开发 等 拓展 知识 ， 涉 及 Android 开发 
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的 方方面面 。 
3.， 紧 跟 技术 趋势 


本 书 针对 目前 手机 普遍 使 用 的 Android 2.2 及 2.3 版 本 进行 讲解 ， 并 涉及 最 新 的 4.0 版 
本 的 变化 ， 据 弃 了 以 前 版 本 中 不 再 使 用 的 知识 ， 适 应 了 技术 的 发 展 趋势 。 


4. 实例 丰富 ， 案 例 典型 ， 实 用 性 强 


本 书 对 每 一 个 知识 点 都 以 实际 应 用 的 形式 进行 讲解 ， 帮 助 读者 理解 和 掌握 相关 的 开发 
技术 。 本 书 最 后 还 提供 了 两 个 典型 的 综合 案例 ， 帮 助 读者 提高 实战 开发 水 平 。 


5 举一反三 


授 人 以 鱼 不 如 授 人 以 渔 。 本 书写 作 由 浅 入 深 、 从 易 到 难 ， 并 注意 知识 之 间 的 联系 ， 让 
读者 学 会 一 个 知识 点 后 ， 能 触 类 旁 通 、 举 一 反 三 ， 编 写 出 相应 的 代码 。 


本 书 内 容 


介绍 了 开发 环境 的 搭建 和 工程 目录 结构 。 

第 2 章 Android 界面 设计 ， 介 绍 Android 基本 的 界面 布局 方式 、 常 见 的 界面 设计 及 UI 
特性 。 学 习 完 本 章 ， 可 以 实现 Android 应 用 开发 中 常见 界面 的 设计 。 

第 3 章 Android 应 用 程序 特性 ， 介 绍 Android 应 用 程序 中 特有 的 组 件 。 掌 握 这 些 组 件 
是 进行 Android 应 用 开发 的 基础 。 

第 4 章 Android 数据 存储 ， 介 绍 Android 开发 中 的 数据 存储 方式 。 掌 握 本 章 内 容 ， 对 
Android 的 数据 处 理 将 会 游 刀 有 余 。 

第 5 章 Android 网 络 通信 ， 介 绍 Android 开发 中 的 网 络 通信 技术 。 作 为 移动 互联 网 的 
重要 组 成 部 分 ，Android 的 网 络 通信 功能 必 不 可 少 ， 是 丰富 Android 应 用 的 基础 。 

第 6 章 Android 多 媒体 开发 ， 介 绍 Android 开发 中 的 音频 、 视 频 等 与 多 媒体 相关 的 技 
术 。 掌 握 本 章 内 容 ， 可 以 让 开发 出 来 的 Android 应 用 程序 更 有 趣味 性 。 

第 7 章 手机 通信 功能 开发 ， 介 绍 Android 系统 针对 手机 实现 的 短信 、 语 音 通话 功能 。 
掌握 本 章 内 容 ， 可 以 开发 出 基本 的 手机 通信 应 用 。 

第 8 章 传感器 、GPS 应 用 开发 ， 介 绍 Android 系统 中 使 用 的 传感器 的 开发 过 程 和 GPS 
的 应 用 开发 。 掌 握 了 本 章 内 容 ， 就 可 以 对 相关 的 硬件 设备 进行 开发 。 

第 9 章 Android NDK 开发 , 介绍 Android 系统 中 的 NDK 开发 环境 的 搭建 及 常用 实例 。 

第 10 章 文件 管理 器 ， 介 绍 Android 应 用 开发 中 常用 文件 管理 器 的 开发 过 程 。 

第 11 章 微 博客 户 端 ， 介 绍 了 Android 应 用 开发 中 微 博客 户 端 的 开发 过 程 。 


本 书 读者 对 象 











口 Android 应 用 开发 初学 者 
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zl 








口 想 从 事 移动 开发 的 人 员 

口 Android 开发 爱好 者 和 研究 者 
口 大 中 专 院 校 的 学 生 

口 相关 培训 班 的 学 员 


本 书 作者 


本 书 由 李 鸥 主笔 编写 ， 其 他 参与 编写 的 人 员 有 段 汶 、 李 宏 功 、 陈 厅 、 毕 梦 飞 、 蔡 成 立 、 
陈涛 、 陈 晓 莉 、 陈 燕 、 崔 栋 栋 、 冯 国良 、 高 岱 明 、 黄 成 、 黄 会 、 纪 奎 秀 、 江 莹 、 靳 华 、 李 
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特别 是 段 弘 、 李 宏 昔 、 陈 厅 在 成 稿 的 过 程 中 ， 不 仅 直接 完成 了 部 分 章节 的 编写 ， 更 是 对 书 
稿 的 完整 性 、 系 统 性 提出 了 宝贵 的 意见 ， 对 本 书 的 成 稿 起 了 很 大 的 作用 ， 特 别 表 示 感 谢 ! 

阅读 本 书 的 过 程 中 若 有 疑问 ， 请 和 我 们 联系 ，E-mail: bookservice2008@163.com。 
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Android 界面 设计 ( 炭 “ 教 学 视频 : 9 付 生 criti 27 
界面 设计 原则 和 流程 … 

2.1.1 界面 设计 原则 … 
2.1.2 界面 设计 基本 流程 
界面 开发 利器 DroidDraw… 
2.2.1 安装 DroidDraw … 
2.2.2 简单 使 用 DroidDraw … 
Android 中 的 基本 布局 Layout … 
2.3.1 水 不 改变 一 一 帧 布局 (FrameLayout) 
2.3.2 ”糖葫芦 一 一 线性 布局 (LinearLayout) … 
2.3.3” 耳 陌 纵横 一 一 表格 布局 (TableLayout) 
2.3.4 我 说 在 哪 就 在 哪 一 一 绝对 布局 (AbsoluteLayout) - 
2.3.5 我 的 邻 桌 一 一 相对 布局 (RelativeLayout) … 
2.3.6 分 而 治之 一 一 切换 卡 (TabWidget) 
2.3.7 犹 抱 琵琶 半 遮 面 一 一 滚动 视图 (ScrollView) - 
2.3.8 列表 (ListView) - 
Android 中 综合 界面 实例 … 
2.4.1 
2.4.2 
243 
2.4.4 
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2.5 Android 中 的 常用 特效 … 
2.5.1 滚动 文字 - 
2.5.2 ”震动 效果 - 












第 3 章 Android 应 用 程序 特性 ( 炭 " 教 学 视频 : 129 分 钟 】 ee 75 
3.1 Activity 一 一 活动 有 





3.1.1 横竖 屏 切 换 … 
3.1.2 拨打 电话 
3.1.3 ”活动 总 结 … 
3.2 ”Service 一 一 服务 
3.2.1 创建 服务 
3.2.2 开始 服务 方式 
3.23 ” 绑 定 服务 方式 
3.2.4 服务 总 结 
3.3 BroadcastReceiver 一 一 广播 
3.3.1 自 定义 广播 … 
3.3.2 系统 广播 一 短 
3.3.3 广播 接收 器 总 
3.4 消息 处 理 
3.4.1 进度 条 更 新 
3.42 搜索 SD 卡 文件 
3.4.3 ”异步 处 理 总 结 … 
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第 4 章 Android 数据 存储 ( 饼 “ 教 学 视频 : 137 分 钟 ) 
4.1 数据 存储 的 方式 
4.2 SharedPreference… 


4.3 
4.3.1 文件 的 保存 和 读 取 
4.3.2 ”SD 卡 文件 的 保存 和 读 取 
4.3.3 文件 存储 总 结 …… 
4.3.4 文件 复制 到 SD 卡 

4.4 ”数据 库存 储 … 
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4.5.4 日 记 本 小 结 … 












































4.6.1 系统 邮件 设置 
4.6.2 发送 邮件 
4.6.3 ”运行 分 析 总 结 … 


4.7.1 共享 的 图 书信 息 … 
4.7.2 内 容 提供 者 (ContentProvider) 
4.7.3 内 容 解 析 器 (ContentResolver) … 
4.7.4 运行 分 析 总 结 

系统 通讯 录 …… i 
4.8.1 系统 通讯 录 的 保存 
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4.8.3 ”显示 通讯 录 联 系 人 
习题 … 


Android 网 络 通信 ( 饼 “教学 视频 : 116 分 钟 ) … 
网 络 通信 方式 
Android 控制 PC 关机 … 
5.2.1 PC 服务 器 端 … 
5.2.2 ”Android 控制 端 : 
5.2.3 ”运行 分 析 总 
Android 即时 聊天 …… 
5.3.1 Android 接收 端 
5.3.2 Android 发 送 端 - 
5.3.3 ”运行 分 析 总 结 
查询 手机 归属 地 
5.4.1 GET 请 求 
5.4.2 POST 请 3 
5.4.3 ”显示 结果 … 
5.4.4 总 结 
天 气 预报 
5.5.1 天 气 获取 
5.5.2 XML 文件 解析 - 
5.5.3 ”结果 显示 … 
5.5.4 总 结 
在 线 翻译 
5.6.1 Web Service 环境 
5.6.2 Web Service 服务 调用 
5.6.3 总结 
简易 浏览 器 
5.7.1 
$72 
5.7.3 的 
5.7.4 RO 
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6.2.3 运行 分 析 总 结 
6.3 视频 播放 器 
6.3.1 多 媒体 播放 类 
6.3.2 ”视频 视图 VideoView 
6.3.3 ”视频 播放 总 结 
6.4 照相 机 PT 
6.4.1 系统 照相 机 … 
6.4.2 简易 相机 … 
6.4.3 照相 总 结 
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随 着 移动 网 络 速 度 的 提升 、 移 动 设备 性 能 的 提升 以 及 人 们 对 移动 设备 功能 要 求 的 提 
高 ，Android 这 一 开放 、 快 速 、 友 好 的 手机 操作 系统 应 运 而 生 并 已 成 煤 原 之 势 。 

在 2012 年 初 , 三星、 摩托 罗拉 、HTC 等 众多 手机 巨头 都 拥有 了 具有 自身 特色 的 Android 
手机 系列 ，Android 系统 手机 也 已 稳 居 智能 手机 发 货 量 的 第 一 位 。 软 件 开 发 方面 ， 大 家 也 
纷纷 加 入 Android 开发 行列 ，Google 官方 市 场 应 用 数量 和 下 载 量 急速 上 升 ， 国 内 各 大 
Android 应 用 市 场 ， 也 开始 拥有 越 来 越 丰富 的 应 用 和 越 来 越 高 的 下 载 量 。 面 对 如 此 火热 且 
具有 无 线 潜力 的 市 场 , 我 们 当然 不 能 错过 这 样 的 机 会 。 接 下 来 , 我 们 就 开始 我 们 的 Android 
应 用 开发 之 旅 。 





1.1 Android 介绍 


早 在 2005 年 7 月 ，Google 公司 收购 了 由 Andy Rubin (Android 之 父 ) 等 人 创立 的 一 家 
小 公司 。 他 们 当时 做 的 就 是 基于 Linux 内 核 的 手机 操作 系统 ， 也 就 是 Android 系统 的 雏形 。 
Google 公司 经 过 多 年 打 详 ， 终 于 在 2007 年 11 月 ， 正 式 向 外 界 展示 Android 操作 系统 并 与 
34 家 手机 制造 商 、 软 件 开发 商 、 电 信 运 营 商 和 芯片 制造 商 共同 创建 开放 手持 设备 联盟 ， 致 
力 于 Android 操作 系统 的 开发 与 推广 ,这 样 , Android 手机 操作 系统 得 到 了 快速 发 展 和 推广 ， 
Android 手机 设备 开始 大 批量 的 生产 。 





1.1.1 Android 发 展 史 


Android 系统 是 一 种 以 Linux 为 基础 的 开放 源码 的 操作 系统 , 主要 使 用 于 便携 设备 。 主 
要 发 行 了 如 下 几 个 版 本 : 


口 Android 1.1 
在 2008 年 9 月 发 布 的 Android 第 一 版 。 
口 Android 1.5 


在 2009 年 4 月 30 日 发 布 ， 命 名 为 Cupcake〈 纸 杯 蛋 糕 ) 。 该 版 本 是 较 稳定 的 第 一 个 
版 本 ， 也 是 第 一 部 Android 手机 G1 使 用 的 操作 系统 。 

口 Android 1.6 

在 2009 年 9 月 15 日 发 布 命名 为 Donut 〈 甜 甜 图 ) 。 该 版 本 主要 对 OpenCore2 媒体 
引擎 进行 了 支持 。 

口 Android 2.0/2.0.1/2.1 
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在 2009 年 10 月 26 日 发 布 ， 命 名 为 Eclair ( 松 饼 ) 。 该 版 本 主要 针对 新 的 浏览 器 的 用 
户 接口 ， 支 持 HTML5、 内 置 相机 闪光 灯 、 数 码 变焦 、 蓝 牙 2.1 等 。 
口 Android 2.2/2.2.1 

在 2010 年 5 月 20 日 发 布 ,命名 为 Froyo〔( 洪 酸奶 ) 。 该 版 本 对 整体 性 能 进行 了 大 幅 
度 的 提升 ， 支 持 Flash 并 提高 了 更 多 的 Web 应 用 API 接口 的 开发 ， 是 当前 Android 手机 中 
最 常见 的 版 本 。 
口 Android 2.3 
在 2010 年 12 月 7 日 发 布 ， 命 名 为 Gingerbread ( 姜 饼 ) 。 该 版 本 主要 简化 了 界面 
升 了 速度 ， 有 更 良好 的 用 户 体验 ， 也 是 目前 主流 的 Android 手机 操作 系统 版 本 。 
口 Android 3.0 
在 2011 年 2 月 2 日 发 布 ， 命 名 为 Honeycomb (蜂巢 ) 。 该 版 本 主要 针对 平板 进行 优 
化 , 全 新 设计 出 了 UI, 增强 网 页 浏览 功能 等 。 该 版 本 用 于 平板 电脑 ， 一 般 不 用 于 手机 设备 。 
口 Android 4.0 
在 2011 年 10 月 19 日 发 布 ， 命 名 为 Ice Cream Sandwich (冰激凌 三 明治 ) 。 该 版 本 使 
用 了 全 新 的 UI 界面 、 更 强大 的 图 片 编辑 功能 、 人 脸 识别 功能 等 ， 对 系统 进一步 优化 ， 速 
意 更 快 ，UI 更 美观 ， 用 户 体 验 更 友好 。 目 前 ， 能 够 使 用 该 版 本 的 Android 手机 比较 少 ， 但 
它 是 未 来 Android 手机 版 本 的 新 要 求 和 趋势 。 
































提 











1.1.2 平台 架构 及 特性 


虽然 ，Android 系统 版 本 不 断 地 进行 着 更 新 ， 但 是 其 平台 架构 是 没有 改变 的 。 其 思想 
是 以 Linux 为 基础 ， 对 不 同 功能 需求 进行 分 层 处 理 ， 各 层 之 间 统 一 接口 ， 不 关心 接口 在 其 
他 功能 分 层 中 的 具体 实现 ， 来 达到 集中 各 自 的 关注 层次 ， 更 好 的 提升 Android 操作 系统 的 
可 适用 性 ， 其 整体 架构 如 图 1.1 所 示 。 
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图 1.1 Android 架构 图 
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从 图 中 可 以 很 明显 地 看 出 Android 操作 系统 分 为 4 层 ， 由 上 而 下 依次 是 应 用 程序 层 、 
应 用 程序 框架 层 、 运 行 库 层 和 Linux 内 核 层 。 


1. 应 用 程序 层 


该 层 是 Android 操作 系统 的 最 上 层 , 所 有 用 户 能 直观 看 到 的 程序 都 是 属于 应 用 程序 层 。 
其 中 ,包括 了 Android 的 一 系列 核心 应 用 程序 包 ， 如 SMS 短 消息 程序 、 日 历 、 浏 览 器 、 联 
系 人 管理 程序 等 ， 也 包括 了 其 他 第 三 方 的 丰富 应 用 。 本 书 将 针对 该 层 的 应 用 程序 的 开发 进 
行 实例 讲解 。 

一 般 来 说 ，Android 的 应 用 开发 都 是 在 其 SDK 的 基础 上 ， 使 用 Java 语言 来 进行 编写 。 
在 绝 大 时 候 也 确实 是 这 样 的 , 但 自从 Android 提供 了 NDK 后 , 可 以 通过 JNI 接口 来 调用 自 
行 开发 的 C/C++ 库 来 进行 处 理 。 但 是 ， 纯 C++ 应 用 依然 是 不 能 运行 在 应 用 层 的 。 


2. 应 用 程序 框架 层 


该 层 是 Android 系统 提供 给 应 用 程序 层 所 使 用 的 API 框架 ， 进 行 应 用 程序 开发 就 需要 
使 用 这 些 框架 来 实现 , 并且 必须 遵守 其 开发 原则 。 这 些 API 框 架 包 含 了 所 有 开发 所 用 的 SDK 
类 库 ， 同 时 也 还 有 一 些 未 公开 接口 的 类 库 和 实现 。 正 是 这 些 未 公开 的 类 库 和 接口 ， 使 得 第 
三 方 的 应 用 程序 可 能 无 法 实现 系统 应 用 程序 的 部 分 功能 。 

从 系统 架构 图 中 可 以 看 出 ， 应 用 程序 框架 层 主要 提供 了 九 大 服务 来 管理 应 用 程序 ， 主 
要 包括 : 

(1) 活动 管理 器 (Activity Manager) 

该 管理 器 用 于 管理 应 用 程序 生命 周期 并 提供 常用 的 导航 回 退 功能 。 

(2) 窗口 管理 器 (Window Manager) 

该 管理 器 用 于 管理 所 有 的 窗口 程序 。 

(3) 内 容 提 供 器 (Content Providers) 

该 组 件 用 于 一 个 应 用 程序 提供 给 其 他 应 用 程序 访问 其 数据 。 这 是 Android 四 大 组 件 之 
一 ， 最 常用 的 应 用 情形 是 系统 中 的 联系 人 数据 库 以 及 短信 数据 库 等 ， 当 然 第 三 方 应 用 程序 
也 可 以 通过 它 来 实现 共享 它们 自己 的 数据 。 

(4) 视图 系统 (View System) 

其 中 包括 了 基本 的 按钮 (Buttons) 、 文 本 框 (Text boxes) 、 列 表 (Lists) 等 视图 ， 这 
些 都 是 在 界面 设计 中 经 常 使 用 到 的 。 除 了 这 些 系统 已 经 定义 的 视图 外 ， 还 提供 了 接口 用 于 
实现 开发 人 员 自 定义 的 视图 。 

(5) 通知 管理 器 (Notification Manager) 

该 管理 器 用 于 应 用 程序 可 以 在 状态 栏 中 显示 自 定义 的 提示 信息 。 

(6) 包 管 理 器 (Package Manager) 

该 管理 器 用 于 Android 系统 内 的 程序 管理 。 

(7) 电话 管理 器 (Telephony Manager) 

该 管理 器 用 于 Android 系统 中 与 手机 通话 相关 的 管理 ， 如 电话 的 呼 入 呼出 、 手 机 网 络 
状态 的 获取 等 。 

(8) 资源 管理 器 (Resource Manager) 

该 管理 器 主要 提供 非 代码 资源 的 访问 ， 如 本 地 字符 串 、 图 形 、 和 布局 文件 (layout files) 等 。 


。3。 
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(9) 位 置 管理 器 (Location Manager) 
该 管理 器 主要 用 于 对 位 置信 息 的 管理 。 主 要 包括 了 非 精确 位 置 定位 的 手机 基站 信息 、 
无 线 热点 信息 ， 以 及 精确 位 置 定位 的 GPS 信息 等 。 


3. 运行 库 层 


在 运行 库 层 中 包括 了 两 部 分 ， 一 部 分 是 开源 的 第 三 方 C/C++ 库 ， 一 部 分 是 Android 系 
统 运行 库 。 第 三 方 的 C/C++ 库 主要 用 于 支持 我 们 使 用 各 个 组 件 ， 主 要 的 库 包括 了 : 

(1) Bionic 系统 C 库 (Libc) 

该 库 是 一 个 从 BSD 继承 来 的 标准 C 系统 函数 库 ， 它 是 专门 为 基于 Linux 系统 的 设备 
定制 的 。 

(2) Surface Manager 

该 库 用 于 对 显示 子 系统 的 管理 ， 并 且 为 多 个 应 用 程序 提供 了 2D 和 3D 图 层 的 无 颖 融合 。 

(3) 多 媒体 库 (Media Framework) 

该 库 基 于 PacketVideo OpenCORE， 使 用 该 库 使 得 Android 系统 支持 多 种 常用 的 音频 、 
视频 格式 的 回放 和 录制 ， 同 时 支持 静态 图 像 文件 等 。 

(4) SQLite 库 

该 库 是 一 个 功能 强劲 的 轻型 关系 型 数据 库 引 擎 。 在 Android 系统 的 数据 存储 中 ， 数 据 
库存 储 是 非常 重要 的 一 种 存储 方式 , 例如 系统 的 短信 、 联系 人 信息 等 都 使 用 数据 库 来 存储 。 

(5) WebKit 库 

该 库 是 一 个 开源 的 浏览 器 引擎 。WebKit 所 包含 的 WebCore 排版 引擎 和 JSCore 引 
擎 ， 其 高 效 稳定 、 兼 容 性 好 。 

Android 的 系统 运行 库 包括 了 一 个 Andorid 核心 库 和 Dalvik 虚拟 机 。 

核心 库 提 供 了 Java 编程 语言 核心 库 的 大 多 数 功能 。Dalvik 虚拟 机 是 Android 的 Java 
虚拟 机 ， 解 释 执行 Java 的 应 用 程序 。 

每 一 个 Android 应 用 程序 都 拥有 自己 的 进程 ， 并 且 都 拥有 一 个 独立 的 Dalvik 虚拟 机 
实例 。 Dalvik 虚拟 机 被 设计 成 同一 个 设备 可 以 同时 高 效 地 运行 多 个 虚拟 系统 。Dalvik 虚 
拟 机 执行 .dex 的 可 执行 文件 ， 该 格式 文件 针对 小 内 存 使 用 做 了 优化 ， 在 手机 等 移动 设备 中 
运行 更 高 效 。 

4. Linux 内 核 层 


Android 的 核心 系统 服务 依赖 于 Linux 2.6 内 核 ， 并 在 其 基础 上 针对 手机 这 样 的 移动 设 
备 进行 了 优化 ， 用 于 提供 安全 机 制 、 内 存 管 理 、 电 源 管 理 、 进 程 管理 、 网 络 协议 栈 和 驱动 
模型 等 。 

除了 提供 这 些 底层 管理 之 外 ，Linux 内 核 层 也 提供 了 硬件 设备 的 驱动 ， 可 以 看 作 是 硬 
件 和 上 层 软 件 之 间 的 抽象 层 ， 为 上 层 提 供 相对 统一 的 接口 。 

这 样 的 层次 划分 ， 使 得 Android 各 层 之 间 分 离 ， 当 我 们 进行 应 用 开发 时 ， 不 需要 过 多 
地 关心 Linux 内 核 、 第 三 方 库 以 及 Dalvik 虚拟 机 等 是 如 何 完成 具体 实现 的 ， 绝 大 部 分 时 候 
只 需要 关注 在 应 用 程序 框架 层 提 供 的 API， 即 使 底层 的 实现 细节 发 生 改 变 ， 也 不 需要 重 写 
上 层 的 应 用 程序 ， 实 现 应 用 程序 开发 适宜 性 、 可 重用 性 以 及 快捷 性 。 
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通过 这 样 的 平台 架构 设计 ， 也 可 以 看 出 Android 系统 可 以 完成 数据 存储 、 网 络 通信 访 
问 、 音 视频 等 多 媒体 的 应 用 、 手 机 短信 通话 等 应 用 ， 以 及 在 硬件 设备 支持 的 基础 上 的 照相 、 
蓝牙 、 无线、GPS 定位 、 重 力 感应 等 丰富 的 应 用 。 接 下 来 , 我 们 一 步 一 步 通过 实例 在 Android 
系统 中 实现 这 些 应 用 开发 。 





1.2 开发 环境 的 搭建 


我 们 已 经 了 解 了 Android 操作 系统 的 发 展 与 其 架构 ， 对 于 这 么 优秀 的 操作 系统 ， 我 们 
当然 要 赶紧 搭建 开发 环境 来 进行 应 用 程序 的 开发 。 

Android 的 开发 可 以 在 Windows 平台 上 进行 ， 也 可 以 在 Linux 平台 中 进行 ， 在 这 两 大 
平台 中 进行 Android 应 用 程序 开发 的 环境 搭建 步骤 是 大 同 小 异 的。 在 这 里 ,我 们 以 Windows 
平台 为 例 进行 开发 环境 的 搭建 。 

Android 的 开发 环境 并 不 是 唯一 的 ， 但 是 使 用 Eclipse 来 进行 Android 应 用 开发 是 目前 

最 快速 便捷 、 最 常见 的 开发 方式 ， 也 是 官方 推荐 的 方式 。 在 这 里 ， 我 们 一 步 一 步 来 实现 在 
Eclipse 下 Android 应 用 开发 环境 的 搭建 。 





1.2.1 Java 下 载 安 装 


Android 的 应 用 程序 都 是 使 用 Java 语言 来 进行 编写 , 要 编译 Java 语言 自然 少不了 JDK 
的 支持 。 有 Java 开发 经 验 的 读者 ， 对 于 JDK 的 安装 与 配置 应 该 不 会 陌生 ， 步 又 如 下 ， 


1. JDK 下 载 


在 进行 Android 开发 时 ， 需 要 选择 JDK 1.5 及 以 上 版 本 。 在 Java 官网 下 载 最 新 的 JDK 
版 本 ， 其 地 址 为 http:/www.oracle.com/technetwork/java/javase/downloads/index.html。 选 择 
最 新 的 JDK 版 本 进行 下 载 ,在 下 载 时 ,需要 注意 自己 使 用 的 操作 系统 平台 ,选择 对 应 的 JDK 
进行 下 载 ， 如 图 1.2 所 示 。 


Java SE Development Kit 7u2 
You must accept the Oracle Binary Code License Aqreement for Java SEto download this 
Software. 


Thank you for accepting the Oracle Binary Code License Agreement for Java SE; 
you may now download this software. 


Product /File Description File Size Download 
Linuxx86 63.62 MB jdk-7u2-limpei586.rpm 

Linuxx86 76.62 MB jdk Tu on 580 ar gz 
Linuxx64 64.51 MB jdk-7u2-liwx-x64.pm 
Linuxx64 77.46 MB jdk-7u2-litx-x64.tar .gz 
Solaris x86 135.87 MB a 
Solaris x86 81.37 MB jdk-7u2-Solaris-i586.tar.gz 

Solaris SPARC 138.94 MB jdk Tu solaris-sparc.tar.Z 
Solaris SPARC 86.05 MB 各 Ja Tu2- aaarisparcdan gz 
Solaris SPARC 64-bit 16.13 MB jdk-7u2-Solaris-sparcv9tar.Z 

Solaris SPARC 64-bit 1231MB 各 

Solaris x64 14.45 MB 章 jdk- 7u2 -solaris x644arZ 
Solaris x64 9.25 MB jdk-7u2-solaris-x64.tar.qz 
Windows x86 84.04 MB 蕴 jdk-7u2-windows-i586.exe 
Windows x64 87.35 ME jdk-7u2-windows-x64.exe 


图 1.2 JDK 下 载 
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2. JDK 安 装 


下 载 完 成 的 JDK 是 一 个 安装 包 程 序 ， 在 Windows 平台 上 双击 执行 即 可 ， 不 再 末 述 。 
3. Java 环 境 配 置 


在 使 用 Java 工具 对 Java 语言 进行 编译 、 运 行 时 ， 必 须 配 置 Java 的 环境 ， 主 要 是 配置 
Java 的 路 径 、Path 和 Classpath 这 三 个 环境 变量 。 

在 Windows 桌面 上 右键 单 击 “ 我 的 电脑 ”, 在 菜单 中 选择 “属性 ”命令 。 在 弹出 的 “ 系 
统 属性 ”界面 中 ， 选 择 “ 高 级 ”选项 卡 ， 在 其 中 选择 “环境 变量 ”， 如 图 1.3 所 示 。 

在 弹出 的 “环境 变量 ”对 话 框 中 ， 选 择 “ 系 统 变量 ”下 的 “新建 按钮 。 在 “新 建 环 
境 变量 ”弹出 框 中 ， 新 建 变量 名 为 “JAVA_HOME”， 变 量 值 为 安装 的 JDK 路 径 ， 如 
“C:\Program Files\Java\jdk1.6.0_10”， 如 图 1.4 所 示 。 










常规 “| 计算 机 各 | [ 窜 规 【计算 机 名 1 硬件 系统 还 原 | 自动 更 新 | 远程 | 

































































要 浊 行 大 多 数 改 动 ， 修 必须 作为 管理 员 营 录 ， 
性 能 
视觉 效果 ,处理 器 计划 ， 内存 使 用 ， 以 及 虚拟 内 存 
设置 加 
用 户 配置 文 件 
与 您 车 录 有 关 的 点 面 设置 
设 村 加 
局 动 和 故障 恢复 
系统 自动 ， 系 统 失败 和 油 斌 信息 人 
EVAndroid\tools\apache-ant-1.6.2 恬 
ET CLASSPATH 了 :AProgran Files\Jeva\jdkl, 6.0_. 
ComSpec D: \WINDOWS\system32\cmd. exe 
FP_NO_HDST.C... WO 
JAVA_HONE 了 :\Progran Files\Java\jdkl.6.0_10 同 | 
CT pp nm “ 
应 用 久 二 
图 1.3 环境 变量 图 1.4 新 建 Java Home 


此 外 ， 还 需要 新 建 一 个 变量 名 为 “JAVA”、 变 量 值 为 安装 的 JDK 的 dtjar 和 tools.jar 
的 路 径 ， 如 “E:\Program Files\Javaijdk1.6.0_10\lib\dt.jar;E:\Program Files\Java\jdk1.6.0_10\lib\ 
tools.jar;.;” 。 

除了 新 建 这 两 个 环境 变量 外 ， 还 需要 添加 一 个 环境 变量 。 找 到 变量 名 为 Path 的 变量 ， 
在 其 变量 值 后 添加 JDK 的 bin 路 径 。 例 如 ， 添 加 “:C:\Program Files\Java\jdk1.6.0_10\bin”， 
如 图 1.5 所 示 。 

添加 这 两 个 环境 变量 完成 后 ， 在 CMD 命令 控制 台中 输入 java -versionp， 查 看 JDK 的 
版 本 信息 ， 安 装 成 功 ， 则 会 输出 安装 的 版 本 。 输 入 如 下 : 


C:\Documents and Settings\Owner>java -version 

java version "1.6.0 29" 

Java (TM) SE Runtime Environment (build 1.6.0 29-b11) 

Java HotSpot (TM) Client VM (build 20.4-b02, mixed mode, sharing) 
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| 系统 属性 -| 
全 天 计划 机 名 | 硬件 “| 高 大 | 未 搞 示 原 | 自动 更 新 | 远程 | 

















archrwindows-x66-msyc9-release 

D:\Progran Files\Mercury\OIY. BE. 

Windows_NT 

D: \WINDOWS\system32;D: \WINDOWS;.. .. 
COM:;. EXE;. BAT: . CMD; . YBS;.YBE: 














图 1.5 添加 Path 


1.2.2 Android SDK 下 载 


在 Android 开发 官网 下 载 SDK， 其 下 载 地 址 为 http://developer.android.com/sdk/ 
index.html， 如 图 1.6 所 示 。 


DevGuide 。 Reference Resources Videos Blog 
wter Package 
EE Download the Android SDK 
DK 
DK Components ‘Welcome Developers! If you are new to the Android SDK, please read the steps below, for an overview of how to set up the SC 
Jmponents If you're already using the Android SDK, you should update to the latest tools or platform using the Android SDK and AVD Ma 
iatform ne SDK starter package. See Adding SDK Components. 
‘torm 
Worm 
ey 29562413 bytes 6b926d0c0a871f1a946e65259984701a 
"latform 
en installer_ri6-windows. exe (Recommended) 29561554 bytes 3521dda4904666b05980590fB3cf469 
Mac OS X (inte) android-sdk_ri6-macosx zip 26158334 bytes ”d1dc2b6fl3eed5e3ce5cf26c4e4c47aa 
inewt 
me ” Linux (386) 。 android-sdk_rl6-linuxtgz 22048174 bytes 3ba4571731d51da3741c29c8830a4583 
ge, 





图 1.6 Android SDK 下 载 


对 于 各 个 操作 系统 平台 下 载 其 对 应 的 Android SDK 版 本 。 在 Windows 平台 中 , 下 载 完 
成 并 解压 后 ，SDK 目录 中 并 没有 Android 的 开发 版 本 。 其 目录 中 主要 包括 了 如 下 几 个 子 


目录 : 


(1) add-ons 


该 目录 为 空 ， 用 于 保存 Google 的 插件 工具 。 
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(2) platforms 

该 目录 为 空 ， 用 于 保存 不 同 版 本 的 SDK 开发 包 。 

(3) tools 

SDK 工具 。 主要 有 模拟 硬件 设备 的 Emulator (模拟 器 ) 、Dalvik 调试 监视 服务 (Dalv 示 
Debug Monitor Service DDMS) 、Android 调试 桥 (Android Debug Bridge ADB) 等 开发 
Android 应 用 程序 必需 的 调试 打包 工具 。 

(4) samples 

Google 官方 示例 代码 。 不 同 版 本 的 SDK，Google 官方 会 提供 其 应 用 程序 的 示例 代码 ， 
这 些 代码 是 进行 Android 应 用 程序 入 门 的 良好 源码 资料 。 





1.2.3 ”Eclipse 下 载 安 装 


在 Eclipse 官网 下 载 Eclipse, 其 下 载 地 址 为 http://www.eclipse.org/downloads/， 如 图 1.7 
所 示 。 
OP) vedipse. erg/ aor ouds/ 


Web| 轧 纸 白银 vBookmarks (01.7) 
hom Dowmay 一 Users 一 Wemuers 一 Commnmrers 一 ESUUCEs 一 riOUecrs 一 FUurOs 


EclipselDownloads 


Packages Developer Builds Projects 


Compare Packages Older Versions ows | 
Ce Eclipse IDE for Java Developers, 128 MB Windows 32 Bit 
Downloaded 3.091 Detail Windows 64 Bi 
Eclipse IDE for Java EE Developers, 212 MB Windows 32 Bit 
We Downloaded 2,187,703 Times Details Windows 64 Bit 
全 Eclipse Classic 3.7.1,174 MB Windows 32 Bit 
Downloaded 1,241,158 Times Details Other Downloads Windows 64 Bit 


Actuate BIRT onDemand 量 Download 
Host, access and deliver your information with BIRT application server on the cloud - plus more... 


合 : Eclipse IDE for CIC++ Developers (includes Incubating components), 时 32 Bi 
107 MB Windows 64 Bit 


Downloaded 668.063 Times 。 Details 


入 Eclipse IDE for JavaScript Web Developers, 110 MB Windows 32 Bit 
Downloaded 250176 Times Details Windows 64 Bt 
CS] Eclipse Modeling Tools, 271 MB Windows 32 Bit 

Downloaded 115,213 Times Details Windows 64 Bit 


图 1.7 Eclipse 下 载 
由 于 Eclipse 是 一 个 开发 的 框架 , 对 于 各 种 语言 的 开发 直接 安装 插件 即 可 。 各 个 版 本 的 
主要 差异 在 于 预先 安装 的 插件 。 在 这 里 ， 我 们 下 载 Eclipse Classic， 即 第 三 个 版 本 。 
下 载 Eclipse 完成 后 是 一 个 压缩 包 ， 直 接 解压 该 包 即 可 。 
1.2.4 ”Eclipse 配置 
完成 了 JDK、Android SDK 以 及 Eclipse 的 下 载 后 , 需要 将 这 三 者 关联 起 来 进行 快捷 的 


8. 
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开发 。Google 公司 针对 Eclipse 的 开发 环境 提供 了 其 开发 插件 Android Development Tools 
CADT) 5 


1. 安装 ADT 插 件 


在 Eclipse 中 安装 ADT 插件 ， 步 又 如 下 : 
(1) 添加 ADT 插件 源 
打开 Eclipse， 在 菜单 栏 中 选择 Help|Install New SoftWare， 出 现 对话 框 如 图 1.8 所 示 。 


单 击 对 话 框 中 的 Add 按钮 ,添加 新 的 插件 。 我 们 使 用 在 线 安装 更 新 ADT 插件 ， 在 
Location 框 中 输入 网 址 : http://dl-ssl.google.com/android/eclipse/。 








F 二 
3 回 加 
Available Software 

Select a site or enter the location of a site. 
二 - | 
Find more software by working with the “Available Software Sites” preferences. 




















回 Show only the latest versions of available software 门下 de itens that are slready installed 


回 @roup itens by category What is already installed? 
Dshow only software applicable to target enviroment 
回 Contsct dl opdate sites during install to find required software 





图 1.8 添加 ADT 源 


(2) 在 线 安装 插件 

输入 网 址 后 ， 单 击 OK 按钮 ，Eclipse 会 自动 到 地 址 源 查 找 需 要 安装 的 工具 包 。 开 发 工 
具 包 获取 完成 后 如 图 1.9 所 示 。 

按照 给 出 的 提示 ,一步 一 步 进行 选择 安装 。 一 般 情 况 下 ， 单 击 Next 按钮 即 可 。 安 装 时 
如 图 1.10 所 示 。 

当 ADT 插件 安装 完成 后 ， 会 提示 重新 启动 Eclipse 程序 。 

2. 配置 安装 SDK 


(1) 配置 SDK 路 径 
ADT 插件 安装 完成 后 ， 需 要 配置 Android SDK 路 径 。 在 Eclipse 的 菜单 中 单 击 
Window|Preferences 命令 ， 出 现 对 话 框 如 图 1.11 所 示 。 
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show only the latest versions of available software Dide itens that are already installed 
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图 1.9 获取 安装 包 
Installing Software 


| b Installing Software 
I 一) 








| DAways run in backeround 














i 
stem EUSA ee 


Note: The list of SDK Tarsets below ic only releaded onee you hit ‘Apply’ or OF . 














图 1.11 配置 SDK 
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在 左边 栏 中 选择 Android， 在 右边 单 击 Browse 按钮 选择 下 载 的 SDK 的 路 径 。 如 果 选 
错 了 就 会 报错 ， 并 显示 该 目录 下 已 有 的 SDK 版 本 信息 。 如 果 没 有 SDK 则 显示 “No target 
available”。 

(2) 下 载 更 新 SDK 

当 配置 了 Android 的 SDK 路 径 后 ， 在 Eclipse 的 菜单 栏 中 可 以 看 到 一 个 小 机 器 人 和 手 
机 的 图 标 ， 如 图 1.12 所 示 。 





了 ile Bait Bu Source Refactor Navigate 


i- 回 六 所 | 晤 ;日 证 名 
图 1.12 Android 开发 管理 图 标 


其 中 ， 左 边 的 机 器 人 图 标 按钮 用 于 开启 SDK 版 本 的 管理 插件 ， 右 边 的 手机 图 标 按钮 
用 于 开启 Android 模拟 器 管理 插件 。 

当 需 要 下 载 或 者 更 新 Android 的 SDK 版 本 时 ， 单 击 手机 图 标 按钮 ， 出 现 对 话 框 如 图 
1.13 所 示 。 


s 
SDK Peth: E:\Android\tools\android-sdl-windows 





DX Android SDK Tools DInstulled 
DR Mndroid SDK Platform-tools 万 Instdled 

WD Android 4.0.3 OFI 15) 

出 口 局 iadroid 4.0 (FI 14) 

宙 口 局 Mndroid 3.2 OPI 13) 

由 口 局 ndroid 3.1 ET 12) 

由 口 局 android 3.0 OPI 11) 

OD Mndroid 2.3.3 (FI 10) 


葬 Instaled 
Tnstaled 


| 
| 

| 口 沪 6oogle APIs by 6opgle Ine. ot jnstalled 
OD 家 Dual Sereen APIs by ATOCERA corporation Wot jinstalled 
| 口 沪 Real39 by LF 里 而 f installed 





ES 
Show: [MUpdates/Wew [VJInstalled [Dobsolete Select Nex or Undates stul 2 packages, .] 
Sort by: OAPI level ORepository Desslect A 


里 本 4 jinstalled 园 











Done loading packages. 








图 1.13 SDK 管理 


如 图 1.13 所 示 ， 在 SDK 管理 界面 中 ， 将 会 罗列 出 最 新 的 Android 开发 工具 版 本 以 及 
所 有 的 Android SDK 版 本 。 读 者 可 以 根据 自己 的 需要 下 载 对 应 的 版 本 。 由 于 目前 手机 使 用 
的 Android 版 本 主要 为 22 和 2.3， 所 以 需要 下 载 2.2 或 2.3 版 本 。 本 书 的 实例 也 是 在 这 两 
个 版 本 上 进行 开发 的 。 

勾 选 了 需要 下 载 的 版 本 之 后 ， 单 击 右 下 角 的 Install packages 按钮 ， 根 据 后 续 提 示 进 行 

(3) 创建 模拟 器 

选择 Eclipse 菜单 栏 中 的 手机 图 标 按钮 ， 出 现 管理 Android 模拟 器 的 对 话 框 ， 如 图 1.14 











二 
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所 示 。 在 图 中 会 列 出 当前 已 经 创建 的 Android 模拟 器 信息 ， 可 以 对 这 个 模拟 器 进行 修改 编 
辑 。 也 可 以 通过 单 击 New 按钮 来 创建 新 的 模拟 器 。 


Tr AS 
List of existing Android Virtual Devices located at D:\Docunents and Settings\Dwner\. android\avd 


AYD Hame Target Name Flatform MPILevel CPWAEBI | 


VA valid Android Virtusl Device A repairable Android Virtual Device. 
XK An Android Virtual Device that failed to load Click Details’ to see the error. 





图 1.14 管理 模拟 器 
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Outi CT] 











Property Value | 
Delete 


加 








JOverride the existing AD vith the same nme 








图 1.15 新 建 模拟 器 
图 1.15 中 ， 在 Name 框 中 输入 新 建 的 模拟 器 的 名 称 ， 该 名 称 没 有 特别 要 求 ， 可 以 根据 


闷气 
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个 人 习惯 进行 命名 。 在 Target 框 中 选择 Android SDK 的 版 本 。 当 下 载 安装 了 多 个 SDK 版 
本 后 ， 可 以 根据 不 同 SDK 创建 不 同 的 模拟 器 ， 但 是 在 代码 测试 时 需要 选择 对 应 的 模拟 器 。 
在 SD Card 中 ， 填 写 模拟 器 中 使 用 的 SD Card 大 小 ， 一 般 使 用 512MB。 在 Skin 的 Build-in 
选择 屏幕 大 小 ， 一 般 为 系统 默认 设置 。 在 Hardware 中 ， 选 择 需要 模拟 的 硬件 设备 ， 在 没有 
特别 的 需求 时 , 不 需要 修改 模拟 的 硬件 ,完成 了 以 上 的 模拟 器 参数 设置 后 , 单 击 Create AVD 
按钮 完成 模拟 器 的 创建 。 

创建 了 模拟 器 后 ， 返 回 模拟 器 管理 界面 ， 如 图 1.14 所 示 。 选 中 创建 的 模拟 器 ， 单 击 
Start 按钮 ， 在 弹出 窗口 中 单 击 Launch 按钮 启动 模拟 器 。 第 一 次 启动 AVD (Android 模拟 
器 ) 时 加 载 较 慢 ， 会 显示 如 图 1.16 所 示 的 界面 等 待 一 段 时 间 。 当 模拟 器 启动 完成 时 ， 就 可 
以 看 到 Android 清爽 的 界面 ， 如 图 1.17 所 示 。 
































图 1.16 AVD 加 载 图 1.17 AVD 启动 完成 
通过 以 上 步骤 ， 我们 就 成 功 地 在 Windows 平台 上 搭建 了 Android 的 开发 环境 。 需 要 下 
载 安装 JDK、Android SDK 以 及 Eclipse， 然后 就 最 重要 的 是 ADT 插件 的 安装 以 及 SDK 和 
Android 模拟 器 的 下 载 、 更 新 与 管理 。 完 成 了 开发 环境 的 搭建 ， 我 们 就 来 创建 一 个 最 基本 
的 Android 工程 。 


1.3 第 一 个 Android 应 用 


在 Eclipse 中 ， 我 们 可 以 非常 便捷 地 创建 、 调 试 Android 的 应 用 程序 。 接 下 来 ， 我 们 就 
创建 一 个 最 基本 的 Android 项 目 。 


1.3.1 创建 Android 项 目 


在 Eclipse 创建 Android 项 目 ， 过 程 比 较 简 单 直 观 : 
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(1) 在 Eclipse 菜单 栏 中 单 击 File[New 命令 ， 在 子 菜单 中 选择 Android Project， 如 果 没 
有 该 选项 ， 则 选择 Other， 如 图 1.18 所 示 。 
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图 1.18 新 建 项 目 


(2) 在 弹出 对 话 框 中 选择 Android， 出 现 多 个 Android 项 目 类 型 ， 如 图 1.19 所 示 。 在 
Android 选项 中 ，Android Project 是 Android 的 一 般 应 用 程序 工程 ， 也 是 我 们 最 常 使 用 的 项 
目 类 型 ，Android Sample Project 是 Android 的 示例 工程 ，Google 官方 发 布 的 示例 代码 即 是 
使 用 的 该 项 目 类 型 ， 一 般 我 们 都 不 会 使 用 ，Android Test Project 是 Android 的 测试 项 目 ， 当 
进行 较 大 的 商业 项 目 工程 时 , 我 们 需要 创建 该 类 型 的 项 目 , 以 测试 Android 应 用 程序 的 性 能 。 








‘Be [CE | Bu | 





图 1.19 选择 项 目 类 型 
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(3) 选择 Android Project, 单 击 Next 按钮 。 在 弹出 的 对 话 框 中 进行 该 项 目的 具体 配置 ， 
如 图 1.20 所 示 。 
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图 1.20 创建 Android 项 目 


在 创建 Android 工程 中 ， 需 要 填写 如 下 几 点 : 

(1) ProjectName 

项 目的 名 称 。 创 建 项 目 后 ， 该 项 目的 所 有 文件 都 将 保存 在 以 该 名 称 命名 的 文件 夹 中 。 

(2) 选择 工程 类 型 

其 中 ， 第 一 项 Create new project in workspace 表示 在 工作 目录 中 创建 一 个 新 的 项 目 。 
当 我 们 新 建 一 个 项 目 时 一 般 使 用 该 选项 ， 第 二 项 Create project from existing source 表示 从 
已 有 代码 中 创建 项 目 。 当 我 们 使 用 没有 配置 文件 的 单纯 的 源码 时 , 会 使 用 到 该 选项 。 例如 ， 
查看 Google 官方 的 示例 代码 时 ; 第 三 项 Create project from existing sample 表示 从 外 部 引入 
一 个 实例 项 目 。 

当 我 们 自己 新 建 项 目 时 ， 都 使 用 第 一 个 选项 创建 一 个 新 项 目 。 

(3) 保存 路 径 

在 Location 中 选择 项 目 保 存 的 路 径 ， 一 般 都 使 用 Workplace 的 默认 路 径 。 如 果 需 要 指 
定 其 他 路 径 ， 不 色 选 Use default location， 然 后 指定 保存 路 径 即 可 。 

填写 好 基本 的 项 目 类 型 后 ， 单 击 Next 按钮 ， 将 会 出 现 选 择 SDK 版 本 的 对 话 框 ， 如 图 
1.21 所 示 。 

在 该 对 话 框 中 将 会 列 出 本 地 已 有 的 所 有 SDK 版 本 。 由 于 我 们 创建 的 模拟 器 使 用 的 是 
2.2 版 本 ， 在 这 里 我 们 选择 Android 2.2。 单 击 Next 按钮 ， 进 入 应 用 程序 基本 信息 界面 ， 如 
图 1.22 所 示 。 
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图 1.21 选择 SDK 版 本 
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图 1.22 应 用 信息 


在 该 对 话 框 中 ,我们 需要 填写 基本 的 应 用 程序 信息 ，Eclipse 将 根据 这 些 基 本 信息 生成 
基本 的 代码 。 需 要 注意 的 是 : 

(1) Application Name 

填写 应 用 程序 的 名 称 。 默 认 情况 下 ， 会 将 前 面 填写 的 项 目 名 称 填写 在 这 里 ， 也 可 以 进 
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行 修改 。 该 名 称 将 作为 应 用 程序 的 名 称 出 现在 手机 应 用 的 列 名 中 。 

(2) Package Name 

Java 源 文件 的 包 名 ，Eclipse 会 自动 在 src 下 创建 该 包 名 。 

(3) Create Activity 

该 栏 为 多 选 框 , 提示 创建 的 类 后 面 是 否 加 上 Activity。 例如 , 我 们 要 创建 的 AndroidTest 
类 ， 如 果 勾 选 ， 那 么 系统 自动 生成 类 名 为 AndroidTestActivity 的 源 文 件 ， 作 为 该 应 用 程序 
的 启动 界面 ， 如 果 不 勾 选 ， 则 只 会 生成 包 ， 不 会 生成 源 文件 。 

(4) Minimun SDK 

指定 开发 环境 使 用 的 最 低 SDK 版 本 。 

完成 了 应 用 程序 信息 的 设置 后 ， 单 击 Finish 按钮 ， 这 样 我 们 就 完成 了 自己 的 第 一 个 
Android 应 用 程序 。 在 Eclipse 中 ， 会 出 现 新 建 项 目的 工程 目录 ， 如 图 1.23 所 示 。 该 目录 中 
的 每 一 个 文件 夹 中 分 类 存放 不 同 的 文件 ， 在 下 一 节 中 我 们 将 详细 介绍 这 些 文件 分 类 。 


I > 日 | 名 了 7” 日 | 
BB androidTest 
re 
日 由 com. ouling AndroidTest 
WD AndroidTestActivity. jave 
由 况 em [cenersted Java Files] 
Hh Android 2.2 
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BG rersble-ldpi 
BB rablendpi 
由 世 leyout 
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9 Androi Manifest. xml 
proguard cfe 
BB project. properties 























图 1.23 新 建 工程 日 录 


1.3.2 ”运行 调试 Android 项 目 


对 于 Eclipse 新 建 的 项 目 , 我 们 不 需要 做 任何 修改 就 是 可 以 直接 运行 。 在 项 目 名 称 上 单 
击 鼠 标 右键 ， 在 菜单 中 单 击 Run aslAndroid Application 命令 。 如 果 当 前 没有 开启 创建 的 
Android 模拟 器 ， 则 会 自动 启动 模拟 器 ; 如 果 当 前 有 两 个 及 以 上 的 Android 设备 (包括 
Android 真 机 和 模拟 器 ) ， 则 会 提示 选择 测试 使 用 的 Android 设备 。 选 择 完 成 后 ， 系 统 自 动 
为 我 们 运行 显示 出 该 应 用 程序 。 在 该 应 用 程序 中 ， 只 是 在 屏幕 中 显示 “Hello World, 
AndroidTestActivity!”。 


1. Android 模 拟 器 的 使 用 


Android 模拟 器 运行 如 图 1.24 所 示 。 模 拟 器 左边 是 显示 屏幕 ， 右 边 是 输入 键盘 和 常用 
的 其 他 按钮 。 在 模拟 器 中 进行 测试 和 真 机 测试 基本 是 一 致 的 ， 但 是 Android 模拟 器 和 真 机 
有 如 下 几 个 主要 的 不 同 : 

(1) 不 支持 实际 的 呼叫 和 接听 来 电 与 短信 ， 但 可 以 通过 控制 台 模拟 电话 和 短信 的 呼 入 
和 呼出 。 
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(2) 不 支持 音频 、 视 频 、 相 机 的 输入 和 捕捉 ， 但 是 支持 输出 。 

(3) 不 能 确定 电池 电量 水 平和 交流 充电 状态 。 

(4) 不 能 确定 SD 卡 的 插入 、 弹 出 。 

(5) 不 支持 蓝牙 、 重 力 感应 器 等 硬件 支持 设备 ， 但 可 以 使 用 控制 台 模拟 位 置信 息 。 
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图 1.24 AndroidTest 模拟 器 运行 


2. DDMS 的 使 用 


在 Android SDK 工具 中 ,提供 了 DDMS (Dalvik Debug Monitor Service) 来 用 于 对 
Android 的 应 用 程序 进行 调试 和 模拟 服务 ， 主 要 提供 了 对 特定 的 进程 查看 正在 运行 的 线程 
以 及 堆 信 息 、 输 入 日 志 (Logcat) 、 广 播 状态 信息 、 模 拟 电话 呼叫 、 接 收 SMS、 虚 拟 地 理 
坐标 、 为 测试 设备 截屏 等 等 。 

DDMS 会 搭建 Eclipse 本 地 与 测试 终端 (Emulator 或 者 真实 设备 ) 的 连接 ， 它 们 应 用 
各 自 独 立 的 端口 监听 调试 器 的 信息 ，DDMS 可 以 实时 监测 到 测试 终端 的 连接 情况 。 当 有 新 
的 测试 终端 连接 后 , DDMS 将 捕捉 到 终端 的 人 D， 并 通过 adb 工具 建立 调试 器 ， 从 而 实现 发 
送 指令 到 测试 终端 的 目的 。 

(1) 开启 DDMS 视图 

在 Eclipse 的 右上 角 有 个 选择 切换 卡 ,选择 DDMS, 如 图 1.25 所 示 。 如 果 没 有 找到 DDMS 
视图 ， 则 在 Eclipse 的 菜单 栏 中 单 击 Window|Open Perspective 命令 ， 选 择 Other， 将 会 出 现 
Eclipse 中 所 有 的 视图 界面 ， 如 图 1.26 所 示 。 选 择 DDMS， 切 换 到 DDMS 视图 。 

(2) DDMS 功能 

在 DDMS 视图 界面 中 ， 有 调试 Android 设备 经 常 使 用 到 的 工具 ， 主 要 包括 了 设备 
(Devices)、 模 拟 器 控制 台 (Emulator Control)、 日 志 输 出 (LogCat)、 文 件 目录 (File Explorer) 
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以 及 线程 、 堆 栈 等 。 这 些 功能 都 显示 在 DDMS 界面 中 。 如 果 在 DDMS 界面 中 没有 找到 这 
些 功能 选项 ， 在 Eclipse 的 菜单 栏 中 单 击 Window|Show View 命令 ， 选 择 Other 选项 ， 将 会 
出 现 Eclipse 中 所 有 的 功能 视图 ， 如 图 1.27 所 示 ， 选 择 需 要 的 功能 视图 进行 添加 。 








图 1.25 DDMS 视图 图 1.26 Open Perspective 


在 DDMS 提供 的 功能 中 ， 我 们 最 常用 的 主要 有 4 个， 分 别 是 : 

口 设备 (Devices) 

设备 功能 视图 一 般 在 DDMS 的 左上 角 ， 其 标签 为 Devices， 如 图 1.28 所 示 。 在 该 视图 
中 显示 所 有 连接 的 Android 设备 并 且 详 细 列 出 该 Android 设备 中 可 连接 调试 的 应 用 程序 进 
程 。 从 图 中 可 以 看 出 列表 中 从 左 到 右 分 别 是 应 用 程序 名 、Linux 的 经 常 ID、 与 调试 器 链接 
的 端口 号 。 在 进行 调试 时 ， 我 们 一 般 只 需要 关心 应 用 程序 名 。 





头目 让 日 龟 和 党 @ 交 ”了 0D 





图 1.27 功能 视图 图 1.28 设备 列表 


当选 择 了 列表 中 的 某 一 个 应 用 程序 时 ， 在 视图 的 右上 和 角 有 一 排 功 能 按钮 就 可 以 使 用 。 
它们 主要 用 于 调试 某 个 应 用 ， 主 要 的 功能 有 调试 选项 (Debug the selected process) 、 线 程 
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查看 (Update Threads) 、 堆 栈 查看 (Update Heap) 、 停 止 进程 〈Stop Process) 和 截屏 
(ScreenShot) 。 

Debug Selected Process: 用 于 显示 被 选择 进程 与 调试 器 的 连接 状态 。 如 果 进 程 前 带 有 
绿色 标识 表示 该 进程 的 源 文件 在 Eclipse 中 处 于 打开 状态 , 并 已 经 开启 了 调试 器 监听 进程 的 
运行 情况 。 

Update Threads: 用 于 查看 当前 进程 所 包含 的 线程 。 当 选中 任意 进程 后 , 单 击 该 按钮 后 ， 
被 选中 的 进程 名 称 后 边 会 出 现 显 示 线 程 信息 标识 并 且 可 以 在 Threads 功能 界面 中 看 到 详细 
的 线程 运行 情况 。 

Update Heap: 用 于 查看 当前 进程 堆栈 内 存 的 使 用 情况 。 当 选中 任意 进程 后 ， 单 击 该 按 
钮 后 ， 可 以 在 Heap 功能 界面 中 看 到 详细 的 堆栈 使 用 情况 ， 与 Update Threads 类 似 。 

Stop Process: 终止 当前 进程 。 选 择 进程 后 ， 单 击 该 按钮 便 强制 终止 了 该 进程 。 

ScreenShot: 截取 当前 测试 终端 桌面 。 

口 模拟 器 控制 台 (Emulator Control) 

由 于 在 模拟 器 中 不 能 直接 使 用 真 机 的 电话 、 短 信 、GPS 位 置 等 功能 ， 当 使 用 模拟 器 测 
试 这 些 功 能 时 ， 我 们 可 以 通过 该 控制 台 来 实现 对 这 些 交 互 功能 的 模拟 。 
模拟 器 控制 台 视 图 一 般 在 设备 视图 的 下 方 ， 如 图 1.29 所 示 。 








ul at ntrol 3 四 
Telephony Status 
Voice: [hone 蕊 sea Jral 司 
Data: [home 国 iwteoy: mm 回 
Telephony Actions 

Ineoming nunber: |123 























图 1.29 控制 台 


各 选项 如 下 : 

Telephony Status: 选择 模拟 语音 质量 以 及 信号 连接 模式 。 

Telephony Actions: 模拟 电话 呼 入 和 发 送 短信 到 测试 的 模拟 器 。 其 中 , Incoming number 
是 设置 本 地 呼 入 模拟 器 的 号 码 ; Voice 选项 表示 模拟 电话 呼 入 模拟 器 ; SMS 选项 表示 模拟 
短信 发 送 到 模拟 器 中 。 

Location Control: 模拟 地 理 坐 标 或 者 模拟 动态 的 路 线 坐 标 变化 ， 并 显示 预 设 的 地 理 标 
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识 。 其中， 有 3 个 选项 卡 表示 可 以 使 用 不 同 的 3 种 方式 ， 分 别 : 

Manually 方式 : 手动 为 终端 发 送 二 维 经 纬 坐标 。 

GPX 方式 : 通过 GPX 文件 导入 序列 动态 变化 地 理 坐 标 ， 从 而 模拟 行进 中 GPS 变化 的 
数值 。 

KML 方式 : 通过 KML 文件 导入 独特 的 地 理 标 识 ， 并 以 动态 形式 根据 变化 的 地 理 坐 标 
显示 在 测试 终端 。 

口 文件 目录 (File Explorer) 

在 DDMS 界面 的 右边 ,占用 较 大 一 块 区 域 的 便 是 模拟 器 运行 的 详细 信息 ， 有 多 个 选项 













Size Date Tine 
HG data 2011-11-19 10:39 dwrxr-x 
已 区 mt 2012-01-29 23:17 drwxrw-x 
2012-01-29 23:17 












WB secure 2012-01-29 23:17 
由 世 systn 2010-07-01 05:06 


图 1.30 文件 目录 


在 文件 目录 中 显示 了 Android 设备 的 文件 系统 信息 。 一 般 情况 下 ,File Explorer 会 有 如 
下 3 个 目录 : data、mnt 和 system。 

在 data 目录 中 对 应 手机 的 RAM， 存 放 Android 系统 运行 时 的 Cache 等 临时 数据 。 如 
果 没 有 root 权限 则 apk 程序 安装 在 /data/app 中 (只 是 存放 apk 文件 本 身 ); 在 /data/data 中 
存放 着 所 有 程序 系统 应 用 程序 和 第 三 方 应 用 程序 ) 的 详细 数据 目录 信息 。 

在 mnt 目录 中 最 重要 的 是 其 目录 下 的 sdcard 目录 ， 该 目录 中 的 文件 即 对 应 SD 卡 的 目 
录 文 件 。 

在 system 目录 中 对 应 手机 的 ROM， 存 放 着 Android 系统 本 身 以 及 系统 自 带 的 应 用 程 
序 等 。 

除了 可 以 查看 到 这 3 个 目录 之 外 ， 还 可 以 使 用 File Explorer 来 对 文件 进行 操作 。 选 项 
卡 右上 角 的 操作 按钮 从 左 到 右 分 别 是 从 Android 设备 保存 到 本 地 、 上 传 到 Android 设备 、 
删除 文件 、 添 加 文件 夹 。 当 然 ， 在 使 用 这 4 个 功能 时 ， 需 要 对 Android 设备 的 文件 系统 具 
有 相应 的 操作 权限 。 

口 日 志 输 出 (LogCat) 

在 模拟 器 中 的 所 有 输出 信息 都 显示 在 日 志 信息 (LogCat) 中， 该 视图 一 般 在 最 下 方 ， 
如 图 1.31 所 示 。 
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图 1.31 日 志 信息 





在 LogCat 中 显示 所 有 测试 终端 操作 的 日 志 记录 ， 通 过 不 同 颜色 的 显示 可 以 很 明显 地 
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区 分 警告 信息 和 错误 信息 。 并 且 可 以 使 用 右边 的 下 拉 菜 单 进行 不 同类 型 信息 的 筛选 。 
3. Debug 调 试 





由 于 Android 应 用 程序 使 用 Java 语言 编写 ， 对 Android 应 用 程序 的 Debug 调试 和 对 标 
准 Java 语言 的 调试 是 相同 的 。 

当 在 工程 文件 中 标记 了 断 点 之 后 ， 可 以 使 用 两 种 方式 开启 调试 : 一 是 右 击 项 目 ， 选 择 
Debug as 从 应 用 程序 开始 运行 就 开启 调试 ; 二 是 在 应 用 程序 运行 后 , 在 DDMS 界面 中 的 设 
备 〈Devices) 选项 卡 中 ,使 用 “调试 ”按钮 开启 调试 。 

















1.4 工程 目录 结构 及 作用 


我 们 已 经 成 功 使 用 Eclipse 来 自动 创建 了 一 个 基本 的 Android 应 用 程序 , 并 详细 讲解 了 
Android 模拟 器 的 使 用 以 及 DDMS 的 各 项 功能 ， 在 这 一 节 中 我 们 将 对 Android 的 工程 目录 
以 及 各 个 目录 中 的 文件 作用 进行 详细 讲解 。 

通过 Eclipse 自动 创建 的 Android 应 用 程序 的 工程 目录 如 前 图 1.23 所 示 , 在 AndroidTest 
工程 项 目下 包含 的 文件 以 及 目录 有 : src、gen、Android2.1、assets、bin、res 这 6 个 文件 日 
录 以 及 AndroidManifest.xml、proguard.cfg 和 project.properties 这 3 个 文件 。 下 面 ， 我 们 对 
这 几 个 目录 进行 分 析 。 


1.. SC 


在 该 目录 中 存放 着 源 文 件 . 对 有 Java 使 用 经 验 的 开发 者 , 应 该 对 该 目录 不 陌生 。 在 Java 
中 我 们 也 使 用 这 样 的 目录 来 存放 Java 代码 。 在 这 个 目录 下 的 子 目录 ( 包 ) com.ouling.AndroidTest， 
是 我 们 新 建 项 目 时 自 定义 的 包 名 ， 其 下 是 我 们 创建 的 源 文件 AndroidTestActivityjava。 


2. gen 


该 目录 用 来 存放 由 Android 开发 工具 所 生成 的 目录 ， 不 用 我 们 开发 者 进行 维护 。 该 目 
录 下 的 所 有 文件 都 不 是 我 们 创建 的 ， 而 是 由 ADT 自动 生成 的 。 在 其 中 有 一 个 与 我 们 创建 
的 包 名 同名 的 二 级 目录 ， 目 录 中 有 一 个 Rjava 文件 。 该 文件 非常 重要 ， 里 面 的 代码 都 是 自 
动 生成 ， 程 序 的 运行 离 不 开 这 个 文件 的 配置 ， 如 下 所 示 : 
public final class R { 
public static final class attr { 
} 


public static final class drawable { 
public static final int ic launcher=0x7f020000; 





j 

public static final class layout { 
public static final int main=0x7f030000; 

1 

public static final class string { 
public static final int app name=0x7f0400017 
public static final int hello=0x7f040000; 

} 

} 


训 
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该 Rjava 文件 中 ,维护 着 一 个 public final class R 类 ,用 于 对 资源 文件 进行 全 局 的 定义 
和 标识 。 在 R.java 文件 中 一 般 有 attr、drawable、id、raw、layout、string 以 及 xml 等 分 别 
用 来 标识 在 工程 中 使 用 到 的 不 同类 型 的 资源 。 如 果 没 有 该 文件 ， 应 用 程序 将 无 法 运行 。 当 
该 文件 丢失 时 ， 可 以 在 Eclipse 菜单 栏 中 单 击 Projectlclean 命令 ， 来 对 项 目 重新 构建 维护 。 


3. Android 2.2 




















这 个 目录 是 用 来 存放 Android 自身 的 所 有 class 文件 。 当 工程 使 用 不 同 的 Android 版 本 
时 , 该 文件 夹 名 和 版 本 名 相同 。 在 目录 中 有 一 个 androidjar 的 文件 , 该 文件 中 包括 了 Android 
系统 所 有 编译 后 的 class 文件 包 ， 在 这 些 包 较为 重要 的 有 : 


OOODOD 


回回 四 加 日 马 日 日 口 晶 量 


android.app: 提供 高 层 的 程序 模型 及 基本 的 运行 环境 。 
android.content: 包含 各 种 对 设备 上 的 数据 进行 访问 和 发 布 的 类 。 
android.database: 通过 内 容 提供 者 浏览 和 操作 数据 库 。 
android.graphics: 底层 的 图 形 库 ， 包 含 画 布 、 颜 色 过 滤 、 点 、 珑 形 ， 可 以 将 它们 直 
接 绘 制 到 屏幕 上 。 

android.location: 定位 和 相关 服务 的 类 。 

android.media: 提供 一 些 类 管理 多 种 音频 、 视 频 的 媒体 接口 。 
android.net: 提供 网 络 访问 的 类 。 

android.os: 提供 Android 的 系统 服务 、 消 息 传输 、IPC 机 制 等 。 
android.opengl: 提供 OpenGL 的 工具 、3D 加 速 。 
android.provider: 提供 类 访问 Android 的 内 容 提 供 者 。 
android.telephony: 提供 与 拨打 电话 相关 的 处 理 类 。 
android.view: 提供 基础 的 用 户 界面 接口 框架 。 

android.util: 涉及 工具 性 的 方法 ， 例 如 时 间 、 日 期 等 操作 。 
android.webkit: 默认 浏览 器 操作 接口 。 

android.widget: 包含 各 种 UI 元素 ， 在 应 用 程序 的 屏幕 中 使 用 。 


这 些 包 提供 的 类 , 在 后 续 的 Android 开发 中 是 会 经 常 使 用 到 的 。 在 实例 开发 的 过 程 中 ， 
我 们 将 依赖 这 些 包 完成 我 们 的 开发 。 

4. Assets 

该 目录 用 来 存放 资源 文件 ， 而 且 此 目录 中 存放 的 资源 文件 都 是 不 进行 编译 的 原生 文 
件 ， 如 应 用 中 使 用 到 的 类 似 于 视频 文件 、MP3 等 的 媒体 文件 。 

5. Bin 


在 该 目录 下 存放 生成 的 可 执行 文件 。 如 果 工 程 项 目 没有 执行 ， 则 该 目录 为 空 。 当 执行 
后 ,目录 下 存放 该 执行 文件 。 在 这 里 ,我 们 介绍 以 下 Android 应 用 开发 中 基本 的 文件 类 型 


口 
口 


Java 文件 : 是 应 用 程序 源 文件 ; 

Class 文件 : 是 Java 编译 后 的 目标 文件 。 不 过 与 标准 Java 不 同 , 在 Android 平台 上 
的 Class 文件 不 能 直接 在 Android 设备 上 运行 。 由 于 Google 使 用 了 自己 的 Dalvik 
来 运行 应 用 ， 所 以 Android 的 Class 文件 实际 上 只 是 编译 过 程 中 的 中 间 文 件 。 
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口 Dex 文件 : 是 Android 平台 上 的 可 执行 文件 。Android 虚拟 机 Dalvik 支持 的 字 节 码 
文件 格式 并 非 标准 Java 字 节 码 ， 而 是 Dex 格式 的 字 节 码 。 

口 Apk 文件 : 是 Android 设备 上 的 安装 文件 。 该 文件 将 AndroidManifest xml 文件 、 
应 用 程序 代码 〈.dex 文件 ) 、 资 源 文件 和 其 他 文件 打 成 一 个 压缩 包 。 一 个 工程 就 
打包 到 一 个 Apk 文件 中 。 




















6. res 


该 目录 用 于 存放 资源 文件 ， 这 些 资 源 文件 都 是 图 标 等 较 小 的 文件 。 

其 中 有 3 个 以 drawable 开头 的 子 文件 夹 ， 分 别 用 来 存放 高 分 辨 率 、 中 等 分 辩 率 、 低 分 
辨 率 的 图 标 文件 ， 不 同 的 分 辨 率 照 片 适应 不 同 的 屏幕 和 运行 环境 。 

layout 文件 夹 下 保存 用 于 界面 布局 的 XML 文件 .Android 系统 中 的 界面 布局 使 用 XML 
来 进行 配置 布局 。 在 Java 代码 文件 中 , 使 用 setContentView(R.layout.main) 方 法 来 指定 使 用 
的 布局 文件 。 

value 子 目 录 ， 其 下 有 一 个 string.xml 文件 ， 这 个 文件 是 用 来 存放 使 用 的 各 种 类 型 的 数 
据 ， 一般 是 文本 信息 和 数值 等 。 最 常用 的 几 种 定义 如 下 : 

口 strings.xml 用 于 定义 字符 串 和 数值 ; 

口 arrays.xml 用 于 定义 数组 ; 

口 colors.xml 用 于 定义 颜色 和 颜色 字 串 数值 ; 

口 dimens.xml 用 于 定义 尺寸 数据 ; 

口 styles.xml 用 于 定义 样式 。 

7. AndroidManifest.xml 
该 


文件 提供 了 该 应 用 程序 的 基本 信息 ， 相 对 于 该 应 用 程序 的 功能 清单 ， 当 系统 运行 该 
程序 之 前 必须 知道 这 些 信 息 。 
在 该 文件 中 必须 声明 在 应 用 程序 中 的 活动 (Activities) 、 服 务 (Services) 、 内 容 提供 
者 〈Content Providers) 以 及 进行 数据 操作 时 需要 的 权限 (permissions) 。 在 Eclipse 中 创建 
的 项 目 中 的 AndroidManifestxml 文件 如 下 : 





01 <?xml version="1.0" encoding="utf-8"?> 
02 <manifest xmlns:android="http://schemas .android.com/apk/res/android" 


03 package="com.ouling.AndroidTest" 

04 android:versionCode="1" 

05 android:versionName="1.0" > 

06 

07 <uses-sdk android:minsdkVersion="8" /> 

08 

09 <application 

10 android:icon="@drawable/ic launcher" 

六 于 android:label="@string/app name" > 

生 肥 <activity 

3 android:name=".AndroidTestActivity" 

14 android:label="@string/app name" > 

15 <intent—filter> 

16 <action android:name="android.intent.action.MAIN" /> 
yj 

18 <category android:name="android.intent.category. 


LAUNCHER™ /> 
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19 </intent-filter> 
20 </activity> 

21 </application> 

22 


23 </manifest> 


其 中 : 02 行 , 标记 命名 空间 。 在 绝 大 部 分 的 AndroidManifestxml 的 第 一 个 元 素 都 是 包 
含 了 命名 空间 的 声明 xmlns:android="http:/schemas.android.conyapkres/android"。 这 样 使 得 
Android 中 各 种 标准 属性 能 在 文件 中 使 用 ， 提 供 了 大 部 分 元 素 中 的 数据 ; 

03 行 ，package 属性 指定 Android 应 用 所 在 的 包 ; 

04 行 ，Android:versionCode 指定 应 用 的 版 本 号 ; 

05 行 ，Android:versionName 是 版 本 名 称 ; 

07 行 ， 定 义 使 用 Android SDK 的 最 低 版 本 ; 

09 行 ， 定 义 该 应 用 的 元 素 、 组 件 和 属性 等 。 在 该 应 用 程序 下 使 用 到 的 组 件 都 必须 在 该 
元 素 中 定义 ; 

10 行 ，icon 属性 是 用 来 设 定 应 用 的 图 标 。 其 中 ， 属 性 值 "@drawable/ic_ launcher" 表 示 
RJjava 文件 中 的 drawable 静态 内 部 类 中 的 ic_launcher 指向 的 资源 ; 

11 行 ，label 属性 用 来 设 定 应 用 的 名 称 。 其 中 ， 属 性 值 "@string/app_name" 表 示 R.java 
文件 中 的 string 中 的 app_name 指向 的 资源 ; 

12 一 14 行 ， 使 用 <activity> 来 注册 一 个 Activity 信息 。 所 有 在 应 用 程序 中 使 用 到 的 
Activity 都 必须 在 该 文件 中 进行 注册 ; 

15 一 19 行 ， 使 用 <intent-filter> 来 声明 了 指定 的 一 组 组 件 支持 的 Intent 值 ， 从 而 形成 了 
IntentFilter。 一 般 在 其 中 都 会 使 用 action 来 标记 组 件 支持 的 意图 动作 (Intent action) 。 使 用 
category 组 件 支持 的 意图 类 型 (Intent Category) 。 如 果 应 用 程序 会 被 用 户 看 作 顶 层 应 用 程 
序 来 使 用 ， 其 中 至 少 需要 一 个 Activity 组 件 来 支持 MAIN 操作 和 LAUNCHER 类 型 。 

除了 上 述 的 标记 类 似 之 外 ， 还 有 一 个 非常 重要 的 权限 申请 必须 在 该 文件 中 完成 。 

其 中 , uses-permission 用 于 请 求 你 的 package 正常 运作 所 需 的 安全 许可 。 当 使 用 应 用 出 
现 安全 限制 时 ， 需 要 进行 注册 申请 。 


8. proguard.cfg 和 project.properties 





这 两 个 文件 都 是 配置 文件 ， 一 般 都 不 需要 我 们 对 其 进行 修改 维护 ， 只 有 当 我 们 导入 已 
有 的 Android 源 工 程 时 可 能 会 使 用 到 。 如 果 该 Android 源 工程 使 用 的 Android SDK 版 本 我 
们 没有 下 载 ， 可 以 通过 更 改 projectproperties 中 target 进行 修改 ， 例 如 : 


target=android-8 


该 语句 表示 使 用 Android SDK 版 本 8， 即 Android 2.2。 如 果 我 们 没有 版 本 8 但 是 有 版 
本 9， 则 修改 该 值 为 9， 并 clean (清理 ) 该 项 目 即 可 。 


在 本 章 中 ， 我 们 介绍 了 Android 的 基础 知识 ， 并 且 在 Windows 平台 下 搭建 了 Android 
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的 便捷 开发 环境 。 成 功 搭建 开发 环境 后 , 使 用 Eclipse 编写 了 基本 的 Android 应 用 程序 项 目 。 
通过 对 该 Android 项 目的 运行 调试 以 及 工程 目录 结构 的 介绍 分 析 , 我 们 已 经 了 解 了 Android 
项 目的 运行 调试 方式 和 文件 的 作用 。 

这 些 都 是 我 们 进行 Android 应 用 开发 的 基础 知识 和 基本 工具 ， 了 解 并 掌握 了 这 些 工具 
之 后 ， 我 们 就 可 以 使 用 这 些 工 具 和 方法 来 进行 Android 应 用 程序 的 开发 。 








1.6 习 题 


【习题 1】 了 解 Android 操作 系统 的 4 层 架构 及 各 层 主要 功能 。 

【习题 2】 说 明 搭 建 Windows 平台 上 的 Android 开发 环境 使 用 的 工具 和 步骤 。 
【习题 3】 创建 和 调试 Android 应 用 程序 的 方法 是 什么 ? 

【习题 4】 说 明 Android 工程 主要 目录 存放 文件 的 作用 。 
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Android 框架 在 设计 之 初 就 为 增强 用 户 体验 ， 预 留 了 比较 丰富 而 友善 的 接口 。 一 个 手 
机 应 用 程序 的 好 坏 ， 主 要 是 由 3 个 因素 决定 的 : 交互 性 良好 的 界面 、 完 整 周全 的 功能 ， 以 
及 低能 耗 。 一 个 风格 友善 ， 易 于 操作 的 界面 ， 可 以 给 用 户 良好 的 第 一 印象 。 本 章 将 为 大 家 
详细 讲解 界面 开发 的 基础 知识 。 


2.1 界面 设计 原则 和 流程 


上 毫 无 疑问 , 一 个 程序 的 界面 是 至 关 重 要 的 。 一般 来 说 , 用 户 倾向 于 选择 界面 简洁 大 方 、 
拥有 适当 特效 的 应 用 程序 。 但 在 现在 的 手机 应 用 程序 开发 中 ， 由 于 软件 市 场 的 激烈 竞争 ， 
程序 开发 人 员 以 及 美工 人 员 经 常 陷入 以 下 两 个 误区 : 第 一 , 开发 人 员 过 分 强调 程序 的 功能 ， 
导致 界面 的 实现 十 分 复杂 ; 第 二 ， 开 发 人 员 过 分 强调 界面 的 特效 ， 寄 希望 于 用 特效 来 吸引 
用 户 有 眼球。 对 于 界面 开发 人 员 来 说 ， 如 何 处 理 功能 和 界面 的 矛盾 ， 显 得 尤为 重要 。 

那么 怎么 样 设计 界面 才能 在 吸引 用 户 和 完善 功能 中 取得 一 个 平衡 呢 ? 如 何 体现 一 个 
界面 设计 的 趣味 性 呢 ? 一 个 完整 的 开发 过 程 中 ， 界 面 设计 的 大 概 流程 又 是 怎样 的 呢 ? 下 面 
就 来 介绍 手机 应 用 程序 的 界面 设计 原则 。 





2.1.1 界面 设计 原则 


界面 的 设计 原则 一 般 有 下 面 几 个 点 : 
口 临近 性 〈Proximity) : 功能 相关 的 项 目 应 当 靠 近 ， 可 以 归 类 成 为 一 组 。 
口 对 齐 (Alignment) : 每 个 元 素 布置 在 界面 当中 时 ， 都 要 考虑 到 和 其 他 元 素 的 视觉 
对 齐 关 系 ， 如 横向 和 纵向 对 齐 。 

口 重复 (Repetition) : 设计 中 一 些 基 本 的 经 典 的 元 素 可 以 适当 地 重复 出 现 ， 既 可 增 
强 条 理性 ， 还 可 以 加 强 统一 ， 代 码 也 符合 重用 原则 。 

口 反差 《Contrast) : 应 当 避 免 界面 所 有 的 基本 元 素 过 于 相似 ， 对 比 能 使 界面 更 加 吸 
引 人 的 注意 。 

在 遵循 手机 应 用 程序 设计 的 基本 原则 的 同时 ， 为 了 使 你 的 应 用 程序 更 加 吸引 用 户 ， 还 
应 兼顾 手机 应 用 程序 的 趣味 性 ， 设 计 人 员 在 设计 时 应 根据 不 同 种 类 手机 特有 的 物理 属性 ， 
例如 ， 手 机 所 支持 的 最 多 的 色彩 数量 、 手 机 支持 的 图 像 格式 ， 还 有 软件 的 应 用 特性 进行 合 
理 的 设计 ， 从 而 最 大 限度 地 利用 手机 现 有 资源 。 

应 用 程序 的 视觉 效果 应 遵循 以 下 设计 原则 : 
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口 适当 增强 界面 的 体积 感 和 质感 ， 使 用 透明 、 半 透明 、 光 滑 等 不 同 效 果 。 

图 形 的 制作 应 避免 在 边缘 使 用 色差 大 的 颜色 ， 推 荐 使 用 渐变 、 羽 化 等 效果 。 

口 考虑 界面 的 整体 色调 ， 推 荐 使 用 同色 调 、 弱 对 比 的 颜色 ， 不 易 使 用 户 产 生 视 觉 
口 风格 统一 、 简 洁 、 直 观 、 大 方 。 使 用 尽量 少 的 颜色 种 类 来 表现 色彩 丰富 的 图 形 图 
像 ， 使 图 形 资源 在 系统 中 占用 的 数据 量 尽量 少 ， 提 高 程序 效率 。 





口 





2.1.2 界面 设计 基本 流程 


根据 积累 的 开发 经 验 ， 手 机 应 用 程序 在 界面 设计 上 一 般 有 以 下 流程 : 
口 根据 手机 应 用 类 型 ， 确 立 整体 风格 。 例 如 ， 轻 快 的 游戏 ， 建 议 使 用 较为 鲜艳 的 颜 
色 ， 而 工具 类 的 小 应 用 ， 则 宜 选 择 较 为 清新 的 颜色 。 
口 根据 手机 GUI 特性 设计 主要 界面 板式 ， 包 括 标题 区 、 功 能 操作 区 、 公 共 导 航 区 。 
> 标题 区 主要 考虑 本 软件 的 Logo、 软 件 版 本 信息 以 及 相关 的 图 文 信息 应 该 如 何 
呈现 。 一 般 推荐 单独 使 用 一 个 页 面 来 说 明 软 件 版 本 等 信息 。 
> 功能 操作 区 是 指 软件 的 主要 操作 区 域 ， 此 区 域 可 操作 的 、 可 控制 的 范围 较 大 ， 
拥有 的 控件 可 能 较 多 ， 是 整个 程序 的 关键 。 
> 公共 导航 区 是 对 软件 进行 宏观 控制 的 区 域 ， 是 所 有 界面 都 可 以 看 见 的 区 域 。 此 
区 域 可 能 有 导航 按键 〈 用 来 切换 到 不 同 界面 ) ，“ 保 存 ”、“ 退 出 ”等 按键 ， 
用 以 灵活 控制 软件 。 
口 根据 每 个 单独 的 界面 ， 可 能 需要 使 用 不 同 的 界面 布局 ， 添 加 不 同 的 控件 ， 用 以 完 
成 基本 功能 ， 并 添加 基本 的 页 面 跳 转 按键 。 
口 为 每 个 按键 和 可 能 需要 的 控件 设计 图 标 造型 ， 按 键 功能 最 好 能 和 相应 图 标 有 一 定 
的 关联 ， 给 用 户 比较 直观 的 提示 。 
最 后 ， 对 界面 和 界面 的 中 的 元 素 ， 进 行 总 体 的 美化 。 遵 循 手机 界面 设计 原则 的 同时 
还 要 使 程序 符合 多 数 用 户 的 操作 习惯 ,图标 和 按键 等 应 保持 新 意 。 


2.2 界面 开发 利器 DroidDraw 


DroidDraw 是 一 个 可 视 化 的 界面 原型 开发 工具 ， 它 基于 Java swing 组 件 ， 可 以 通过 它 
来 生成 复杂 的 Android 程序 界面 ， 同 时 它 使 得 Android 的 Layout 和 Java swing 中 的 Layout 
有 很 好 的 对 应 ， 能 够 使 代码 写 起 来 比较 容易 。 由 于 DroidDraw 比较 轻 量 级 ， 这 里 推荐 大 家 
使 用 它 来 进行 原型 设计 ， 下 载 地 址 为 http://www.droiddraw.org。 





2.2.1 安装 DroidDraw 


目前 DroidDraw 可 以 在 Mac、Windows 和 Linux 上 运行 。 下 载 完毕 后 解压 缩 得 到 的 文 
件 如 图 2.1 所 示 。 

安装 DroidDraw 的 步骤 如 下 : 

(1) 直接 运行 droiddraw.exe 就 可 以 了 ， 图 2.2 是 DroidDraw 的 程序 主 界面 。 
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者 久 droiddray. exe 
二 | readme. txt 
三 | 文本 文档 
三 J 





图 2.1 下 载 完成 后 得 到 的 文件 
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图 2.2 ”DroidDraw 的 程序 主 界面 


这 个 部 


(2) 在 整个 界面 的 左边 是 即 见 即 得 的 ， 可 以 很 方便 地 显示 所 画 的 界面 效果 。 这 个 部 分 
可 以 选择 根 布局 和 屏幕 尺寸 ， 如 图 2.3 所 示 。 
(3) 在 界面 的 右上 部 分 可 以 选择 各 类 控件 、 | SSreen 


子 布 局 、 颜 色 资 源 和 String 类 型 的 值 ， 控 件 和 子 Root Layout: AbsoluteLayout ™ 
布局 都 可 以 直接 拖 放 到 左边 的 屏幕 上 ， 然 后 更 改 Screen Size: JWGA Portrait 所 
各 类 控件 的 属性 ， 如 图 2.4 所 示 。 

(4) 在 右 下 角 的 部 分 是 输出 部 分 ， 它 显示 了 
当前 界面 相对 应 的 xml 文件 ， 并 可 以 通过 左上 角 
的 File 菜单 保存 ， 甚 至 还 可 以 导出 到 APK 或 者 设备 上 ， 如 图 2.5 所 示 。 











图 2.3 左上 角 的 界面 选项 


2.2.2 简单 使 用 DroidDraw 








下 面 我 们 来 简单 使 下 DroidDraw， 首 先 我 们 在 Widgets 中 选中 Button 控件 ， 将 它 
直接 拖 放 至 左边 的 屏幕 中 ， 如 图 2.6 所 示 。 
再 双击 屏幕 中 的 Button， 可 以 在 右上 角 更 改 它 的 属性 ， 如 图 2.7 所 示 。 
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-一 一 -一 Save As 


Widgets | Layouts Properties | Strings | Colors | Arrays | Support Export as .ok rtrait ™ 











Export to device 


Button CheckBox (RadoButon poaioerop rp 4 4 4 dead Preferences 


Quit Ctrl+98 
Gridyiaw 
| En |Autocomplete Tedvew 三 和” 


图 2.4 可 供 选择 的 控件 图 2.5 文件 操作 选项 


回 午 9:24 


DroidDraw 

















Id aywiaget31 | 
Width ap_eontent | 
Height sp_content | 
Backer ound Color | | 

图 2.6 添加 一 个 Button 图 27 Button 的 属性 


可 以 看 到 有 控件 的 ID、 宽 度 、 长 度 、 背 景色 、 布 局 方式 、 是 否 可 见 等 属性 可 供 选 择 和 
更 改 。 我们 将 Text 属性 中 的 Button 重新 写成 OK, 在 Font size 属性 填 上 17sp, 在 Text color 
中 选择 上 颜色， 选择“#Hfff3333” 红 色 。 然 后 单 击 Apply 应 用 ， 可 以 看 到 按钮 的 变化 ， 如 图 
2.8 和 图 2.9 所 示 。 























D 回 四 te: ##sx= 
样品 六 本 样 时 文本 


国 = 国 + 





图 2.8 可 自 定义 的 颜色 图 2.9 修改 好 的 Button 
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最 后 在 左上 角 单 击 Generate 按钮 生成 所 需 的 xml 文件 ， 如 图 2.10 所 示 。 
生成 的 xml 文件 如 图 2.11 所 示 。 











Dutput 
9xml version="1.0” encoding="utf-8"?> 

<AbsoluteLayout 

android:id="@tid/widget0” 

android: layout_width="fill_parent” 

android: layout_height="fill_parent” 
xnlns:android="http://schemas. android. com/ apk/res/android” 
> 

<Button 

android:id-"@tid/widget31” 
android:1ayout_width="wrap_content” 








; Generate Load lndo Redo 





图 2.10 生成 xml 图 2.11 ”Output 的 输出 


xml 文件 可 以 在 原型 设计 好 之 后 ， 直 接 复 制 到 工程 中 使 用 。 通 过 以 上 可 以 看 到 ， 轻 量 
级 的 工具 DroidDraw 进行 界面 原型 设计 还 是 很 方便 的 。 


2.3 Android 中 的 基本 布局 Layout 


手机 应 用 程序 相对 于 一 般 PC 应 用 程序 来 说 ， 有 自己 独特 之 处 ， 一 般 的 手机 分 辨 率 为 
320X240 或 者 480X320, 这 使 得 界面 控件 相对 有 限 ， 要 想 实现 丰富 的 功能 ， 就 必须 在 开发 
中 灵活 使 用 各 种 Layout， 并 在 Layout 中 布置 合适 的 控件 去 完成 程序 的 功能 。 

Android 的 程序 通常 都 由 几 个 页 面 组 成 ， 每 个 页 面 通常 对 应 一 个 xml 文件 ， 而 在 界面 
中 放置 控件 之 前 ， 要 确定 这 个 页 面 是 用 什么 样 的 Layout (布局 ) ，Layonut 定义 了 控件 之 间 
的 视觉 关系 ， 它 们 是 采用 什么 样 的 方式 对 齐 的 。 

当然 可 以 在 一 个 Layout 中 再 能 套 其 他 Layout, 控件 的 对 齐 方 式 是 以 包 于 它 们 的 Layout 
为 准 ，Android 中 有 以 下 一 些 基 本 的 Layout: 帧 布局 (FrameLayout) 、 线 性 布局 
(LinearLayout) 、 相 对 布局 (RelativeLayout) 、 绝 对 布局 (AbsoluteLayout) 、 表 格 布局 
(TableLayout) 。 除 了 以 上 基本 布局 外 还 有 两 种 可 以 被 当成 是 背景 布局 的 控件 : 切换 卡 
(CTabwidget) 和 滚动 视图 (ScrollView) 。 





2.3.1 永 不 改变 一 一 帧 布局 (FrameLayout) 

帧 布局 是 最 简单 的 布局 ， 它 具有 以 下 特点 : 所 有 子 元 素 都 被 钉 在 屏幕 的 左上 角 ， 不 能 
为 子 元 素 指定 位 置 。 下 面 我 们 就 用 DroidDraw 来 验证 FrameLayout 以 上 的 特性 。 

(1) 首先 运行 DroidDraw， 在 界面 右上 角 的 控件 区 的 Layouts 中 选择 FrameLayout， 并 
拖 放 至 界面 左边 的 “屏幕 ”上 ， 并 使 得 FrameLayout 布 满 整 个 屏幕 ， 如 图 2.12 所 示 。 

(2) 在 控件 区 的 Widgets 中 选择 Button， 并 将 Button 拖 忠 至 刚刚 的 FrameLayout 中 ， 
这 时 会 提示 你 选择 将 Button 放 到 哪个 Layouts 中 ， 如 图 2.13 所 示 。 

我 们 选择 FrameLayout， 单 击 它 即 可 。 可 以 看 到 按钮 控件 己 经 被 加 入 到 帧 的 布局 中 ， 
如 图 2.14 所 示 。 
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剖 仿 下 午 7:33 


DroidDraw 


下午 8:06 
DroidDraw 


FraneLayout 


AbsoluteLayout 





图 2.12 ” 帧 布局 充满 了 整个 界面 图 2.13 选择 在 哪个 布局 中 安放 你 的 控件 
(3) 重复 刚刚 的 动作 ， 再 往 FrameLayout 帧 布局 中 添加 一 个 Button， 即 现在 在 这 个 帧 
布局 中 有 两 个 Button 控件 ， 这 时 可 以 看 到 两 个 Button 重 登 在 了 一 起 ， 如 图 2.15 所 示 。 


回 出 园 下 于 8:15 
回 | (加 下 午 8:07 DroidDraw 





图 2.14 添加 第 一 个 Button 图 2.15 继续 添加 第 二 个 Button 


(4) 单 击 Generate 按钮 ， 在 Output 检查 输出 的 xml 文件 ，xml 文件 的 代码 如 下 所 示 : 





01 <?xml version="1.0" encoding="utf-8"?> 
02 <AbsoluteLayout 


03 android:id="@+id/widgetO0" // 定 义 控件 在 资源 文件 中 的 ID 
04 android:layout width="fill Parent" // 定 义 控件 宽度 ， 充 满 父 类 容器 
05 android:layout height="fill parent" // 定 义 控件 的 高 度 ， 充 满 父 类 容器 


06 xmlns:android="http://schemas.android.com/apk/res/android" 


// 定 义 命名 空间 


O72 > 

08 <FrameLayout 

09 android:id="@+id/widget29" // 定 义 控件 在 资源 文件 中 的 ID 

10 android:layout width="318px" // 定 义 宽度 

11 android:layout height="431px" // 定 义 高 度 

12 android:layout x="1px" // 定 义 控件 的 位 置 距离 左边 的 距离 
13 android:layout y="1lpx" // 定 义 控件 的 位 置 距离 上 边 的 距离 
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15 <Button 


16 android:id="e+id/widget32" // 定 义 控件 在 资源 文件 中 的 ID 
17 android:layout width="wrap content" // 定 义 控件 的 宽度 ， 包 庄内 容 
18 android:layout height="wrap content" // 定 义 控件 的 高 度 ， 包 庄内 容 
19 android:text="Button" // 定 义 控件 初始 显示 的 内 容 
20 > 


21 </Button> 
22 <xButton 


23 android:id="@+id/widget33" // 定 义 控件 在 资源 文件 中 的 ID 
24 android:layout width="wrap content" // 定 义 控件 的 宽度 ， 包 庄内 容 
25 android:layout height="wrap content" // 定 义 控件 的 高 度 ， 包 里 内 容 
26 android:text="Button" // 定 义 控件 初始 显示 的 内 容 
ne 


28 </Button> 

29 </FrameLayout> 

30 </AbsoluteLayout> 

其 中 ，02 一 07 行 ， 定 义 了 一 个 AbsoluteLayout 绝对 布局 ; 

08 一 14 行 ， 在 绝对 布局 中 定义 了 一 个 FrameLayout 帧 布局 ; 

15 一 28 行 ， 在 帧 布局 中 包含 了 两 个 Button 控件 ，ID 分 别 是 widget32 和 widget33， 而 
由 于 帧 布局 中 所 有 子 元 素 将 被 钉 在 屏幕 的 左上 角 ， 不 能 为 子 元 素 指定 位 置 的 特点 ， 使 得 两 
个 Button 控件 重合 了 ， 所 以 看 起 来 在 帧 布局 中 只 有 一 个 Button; 

29 一 30 行 ， 定 义 帧 布局 和 绝对 布局 的 结束 ， 必 须 对 应 定义 。 


2.3.2 ” 糖 荫 芦 一 一 线性 布局 (LinearLayout) 


线性 布局 ， 顾 名 思 义 是 指 在 垂直 或 者 水 平方 向 上 对 齐 所 有 子 元素 ， 所 有 子 元 素 一 个 接 
-个 排列 ， 如 果 是 在 垂直 方向 上 对 齐 ， 则 一 行 只 有 一 个 元 素 ， 而 不 管子 元 素 的 高 度 ， 均 以 
子 元 素 的 最 左边 为 母线 进行 对 齐 ， 如 果 是 在 水 平方 向 上 对 齐 ， 则 一 列 只 有 一 个 元 素 ， 而 不 
管子 元 素 的 宽度 ， 均 以 子 元 素 的 最 上 端 为 母线 进行 对 齐 。 下 面 我 们 就 以 DroidDraw 进行 验证 。 

(1) 首先 运行 DroidDraw， 在 左上 角 的 Root Layout 中 选择 LinearLayout， 如 图 2.16 所 示 。 
此 时 默认 的 是 垂直 方向 上 的 对 齐 。 

(2) 然后 拖 电 3 个 Button 控件 ， 放 到 LinearLayout 中 ， 调 整 第 二 个 和 第 三 个 Button 
的 大 小 。 可 以 看 到 不 论 怎么 调整 ，3 个 Button 始终 在 最 左 端 对 齐 ， 如 图 2.17 所 示 。 


Screen 
Root Layout : LinearLayout ™Y 
Screen Size: HYGA Portrait ™Y 








图 2.16 选择 好 根 布局 图 2.17 垂直 的 线性 布局 
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(3) 重新 新 建 一 个 文件 ， 仍 然 将 根 布 局 选 成 LinearLayout， 双 击 这 个 布局 ， 在 右边 
Properties 的 选项 中 找到 Orientation 这 个 属性 ， 将 其 选择 成 horizontal， 如 图 2.18 所 示 。 然 
后 单 击 Apply 按钮 。 

(4) 同样 拖 电 3 个 Button 控件 至 当前 LinearLayout 布局 中 ， 可 以 看 到 不 论 如 何 改变 每 
个 Button 的 大 小 ， 控 件 均 以 最 上 端 为 母线 进行 对 齐 ， 如 图 2.19 所 示 。 

















Widgets | Layouts | Properties | Strings | Colors | Arrays | Support 

















Botton Nargin opx | 
Left Nargin Opx 
Right Nargin Dpx 
Drientation horizontal Y 
ee ET 
Cz] 
图 2.18 调整 根 布局 的 属性 图 2.19 水 平方 向 上 的 线性 布局 


2.3.3” 陡 陌 纵横 一 一 表格 布局 (TableLayout) 


表格 布局 ， 顾 名 思 义 ， 想 象 一 下 整个 布局 是 一 个 大 的 表格 ， 有 很 多 行 和 列 、 很 多 的 单 
元 格 ， 子 元 素 都 被 放 在 一 个 一 个 的 单元 格 中 ， 单 元 格 不 能 跨 列 ， 但 可 以 为 空 ， 列 可 以 设置 
为 可 伸展 的 ， 从 而 适应 整个 屏幕 ， 但 在 实际 中 ， 并 不 会 显示 这 些 想象 中 的 “ 行 ” 和 “ 列 ” 
的 线 。 一 个 TableLayout 会 拥有 很 多 的 TableRow( 行 ) ， 每 一 行 中 又 会 有 Column 来 定义 
列 。 我 们 来 看 使 用 TableLayout 来 实现 文件 操作 列表 的 例子 ， 我 们 新 建 一 个 如 图 2.20 所 示 
的 工程 Mytablelayout。 


日 Nytablelayout 

由 sre 

由 gen [Generated Java Files] 

BM Mndroid 2.2 

EE assets 

由 bin 

日 也 res 
HE drawable-hdpi 
HE rawable-ldpi 
HG rawsble-mdpi 
SG layout 

DO main. xml 

HE values 
9 mdroialanifest. xml 
下 proguard cfg 

目 project. properties 


[3 





图 2.20 表格 布局 例子 的 工程 
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并 





在 布 





局 文件 main.xml 中 重 写 入 以 下 代码 : 


<?xml version="1.0" encoding="utf-8"?> 
<TableLayout xmlns:android=http://schemas.android.com/apk/res/ 


android 


// 定 义 命名 空间 
// 定 义 控件 宽度 ， 充 满 父 类 容器 





android:layout width="fill parent" 





android:layout height="fill parent" // 定 义 控件 的 高 度 ， 充 满 父 类 容器 
android:stretchColumns="1"> // 定 义 列 是 否 可 以 被 拉 伸 
<TableRow> 
<TextView 
android:layout column="0" // 定 义 控件 的 位 置 此 处 表示 在 第 一 列 中 
android:text=" 打 开 ..." // 定 义 控件 初始 显示 的 内 容 
android:padding="3dip" /> // 定 义 控件 的 距离 
<TextView 
android:text="Ctr1-O" // 定 义 控件 初始 显示 的 内 容 
android:gravity="right" // 定 义 控件 在 父 类 容器 中 布局 的 位 置 
android:padding="3dip" /> // 定 义 控件 的 距离 
</TableRow> 
<TableRow> 
<TextView 
android:layout column="0" // 定 义 控件 的 位 置 此 处 表示 在 第 一 列 中 
android:text=" 保 存 ..." // 定 义 控件 初始 显示 的 内 容 
android:padding="3dip" /> // 定 义 控件 的 距离 
<TextView 
android:text="Ctrl-S" // 定 义 控件 初始 显示 的 内 容 
android:gravity="right" // 定 义 控件 在 父 类 容器 中 布局 的 位 置 
android:padding="3dip" /> // 定 义 控件 的 距离 
</TableRow> 
<TableRow> 
<TextView 
android:layout column="0" 
android:text=" 另 存 为 ..." // 定 义 控件 初始 显示 的 内 容 
android:padding="3dip" /> 
<TextView 
android:text="Ctr1-Shift-S" 
android:gravity="right" 
android:padding="3dip" /> 
</TableRow> 
<View 
android:layout height="2dip" // 定 义 控件 高 度 
android:background="#FF909090" />  // 定 义 背景 颜色 
<TableRow> 
<TextView 
android:text=" 导 入 ..." 
android:padding="3dip" /> 
</TableRow> 
<TableRow> 
<TextView 
android:text=" 导 出 ..." 
android:padding="3dip" /> 
<TextView 
android:text="Ctrl-E" 
android:gravity="right" 
android:padding="3dip" /> 
</TableRow> 


。3S。 


实战 Android 应 用 开发 











56 <View 

7 android:layout height="2dip" 

58 android:background="#FF909090" /> 
59 <TableRow> 

60 <TextView 

61 android:layout column="0" 

62 android:text=" 退 出 " 

63 android:padding="3dip" /> 

64 </TableRow> 


65 </TableLayout> 


其 中 ，02 一 05 行 ， 定 义 了 一 个 表单 布局 TableLayout; 

06 一 15 行 , 定义 了 表单 中 的 一 行 TableRow。 在 该 TableRow 中 又 包含 了 两 个 TextView 
件 在 第 几 列 ; 

38 一 40 行 ，View 控件 的 代码 定义 了 一 条 分 割 线 。 其 中 ，android:layout_height="2dip" 
这 个 代码 说 明 分 割 线 的 高 度 为 2 个 dip，android:background="#FF909090" 将 背景 色 颜色 设 
为 银灰 色 ; 

其 他 代码 类 似 ， 在 本 TableLayout 中 包含 了 6 个 TableRow ( 行 ) 。 
了 运行 这 个 程序 ， 在 Eclipse 的 工程 的 Run as 中 选择 Android Application 运行 程序 ， 
可 以 看 到 如 图 2.21 所 示 的 效果 。 








Mytablelayout 





图 2.21 表格 布局 的 效果 


2.3.4 我 说 在 哪 就 在 哪 一 一 绝对 布局 (AbsoluteLayout) 


绝对 布局 ， 意 思 是 用 屏幕 上 的 像素 来 定义 控件 的 位 置 ， 一 般 来 说 是 用 子 元 素 的 最 左上 
角 来 指 代 整 个 子 元 素 的 位 置 ，(0, 0) 是 指 起 始 位 置 在 屏幕 的 左上 角 ， 当 子 元 素 下 移 或 者 右 移 
时 ， 子 元 素 的 x 或 者 y 坐标 也 相应 增 大 。 不 过 现在 很 少 使 用 AbsoluteLayout 绝对 布局 ， 因 
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为 实际 应 用 中 各 种 手机 的 屏幕 分 辩 率 并 不 一 样 ， 在 这 个 设备 上 调 好 了 控件 的 距离 ， 往 往 很 
难 在 别 的 种 类 的 移动 终端 上 使 用 。 
我 们 将 以 下 代码 ， 复 制 并 保存 成 testlayoutl.xml， 并 用 DroidDraw 打开 : 


01 <?xml version="1.0" encoding="utf-8"?> 
02 <AbsoluteLayout 








03 xmlns:android=http://schemas .android.com/apk/res/android 

// 定 义 命名 空间 
04 android:id="@+id/absoluteLayoutl1" // 定 义 控件 在 资源 文件 中 的 ID 
05 android:layout _ width="fil1 parent" // 定 义 控件 宽度 ， 充 满 父 类 容器 
06 android:layout _ height="fil1 parent" > // 定 义 控件 的 高 度 ， 充 满 父 类 容器 
07 
08 <Button 
09 android:id="@+id/button1" // 定 义 控件 在 资源 文件 中 的 ID 
10 android:1layout width="120dp" // 定 义 控件 的 宽度 
android:layout height="100dp" // 定 义 控件 的 高 度 
12 android:layout x="20dp" // 定 义 控件 的 位 置 距离 左边 的 距离 
13 android:layout y="30dp" // 定 义 控件 的 位 置 距离 上 边 的 距离 
14 android:text="Button" /> 
bo 


16 </AbsoluteLayout> 


其 中 ，02 一 06 行 ， 定义 了 布局 为 绝对 布局 AbsoluteLayout; 

08 一 14 行 ， 定 义 了 布局 中 Button 的 位 置 。 其 中 ，android:layout_x="20dp" 和 android: 
layout_y="30dp" 标 明了 Button 起 始 的 位 置 android:layout width="120dp" 和 android:layout_ 
height="100dp" 标 明了 Button 控件 的 大 小 。 在 DroidDraw 加 出 @ 下 sor 
中 的 显示 效果 如 图 2.22 所 示 。 DroidDraw 

这 里 顺带 提 一 下 Android 开发 中 可 能 使 用 到 的 长 度 
单位 : 

口 px: 表示 屏幕 实际 的 像素 。 例 如 ，320X480 的 屏 
幕 在 横向 有 320 个 像素 ， 在 纵向 有 480 个 像素 。 
口 in: 表示 英寸 ， 是 屏幕 的 物理 尺寸 。 每 英寸 等 于 
2.54 厘米 。 例 如 ， 形 容 手机 屏幕 大 小 ， 经 常 说 ， 
3.2 ( 英 ) 寸 、3.5〈 英 ) 寸 、4( 英 ) 寸 就 是 指 这 
个 单位 。 这 些 尺寸 是 屏幕 的 对 角 线 长 度 。 如 果 手 
机 的 屏幕 是 3.2 英寸 ， 表 示 手 机 的 屏幕 (可 视 区 
域 ) 对 角 线 长 度 是 3.2X2.54 = 8.128 厘米 。 

口 mm: 表示 毫米 ， 是 屏幕 的 物理 尺寸 。 

口 pt: 表示 一 个 点 ， 是 屏幕 的 物理 尺寸 。ipt 大 小 为 

1 英寸 的 1/72。 

口 dp (与 密度 无 关 的 像素 ) : 逻辑 长 度 单位 , 在 160 国 222 结对 人 局 的 效果 
dpi 屏幕 上 ，1dp=1px=1/160 英寸 。 随 着 密度 变化 ， 对 应 的 像素 数量 也 变化 ， 但 并 
没有 直接 的 变化 比例 。 

口 sp“〈 与 密度 和 字体 缩放 度 无 关 的 像素 ) : 与 dp 类 似 ， 根 据 用 户 的 字体 大 小 设置 进 
行 缩放 。 

一 般 来 说 ， 尽 量 使 用 dp 作为 空间 大 小 的 单位 ， 而 使 用 sp 作为 文字 大 小 的 单位 。 
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2.3.5 我 的 邻 桌 一 一 相对 布局 CRelativeLayout) 


相对 布局 ， 顾 名 思 义 是 指 通过 相对 于 其 他 元 素 或 者 父 类 容器 〈 用 控件 ID 来 指定 ) 来 
布置 子 元 素 的 位 置 。RelativeLayout 相对 布局 通常 通过 一 些 参数 ， 如 ToLeft、AlignTop 和 
Below 等 来 指定 这 个 子 元 素 相对 于 其 他 元 素 或 者 父 类 容器 的 位 置 。 我 们 将 以 下 代码 复制 并 
保存 成 testlayout2.xml， 并 用 DroidDraw 打开 : 


01 <?xml version="1.0" encoding="utf-8"?> 
02 <RelativeLayout 


03 xmlns:android=http://schemas.android.com/apk/res/android 
// 定 义 命名 空间 
04 android:id="@+id/relativeLayout1" 
05 android:layout width="fill parent" 
06 android:layout height="fill parent" > 
07 
08 <Button 
09 android:id="@+id/buttonl1" 
10 android:layout width="wrap content" 
jl android:layout height="wrap content" 
12 android:layout alignParentTop="true" 
// 定 义 控件 在 父 类 容器 中 的 位 置 ， 此 处 保持 在 顶部 
23 android:layout centerHorizontal="true" 
// 定 义 控件 在 父 类 容器 中 的 位 置 ， 此 处 表示 保持 水 平 正中 
14 android:layout marginTop="106dp" // 定 义 控件 距离 顶部 的 距离 
15 android:text="Buttonl" /> 
16 
17 <Button 
18 android:id="@+id/button2" 
19 android:layout width="wrap content" 
20 android:layout height="wrap content" 
2 android:layout below="@id/button1" 
22 android:layout centerHorizontal="true" 
2 android:text="Button2" /> 
24 


25 </RelativeLayout> 


其 中 ，02 一 06 行 ， 定 义 了 一 个 相对 布局 RelativeLayout; 

08 一 15 行 ， 定义 了 一 个 Button1。 其 中 ，android:layout_ 
alignParentTop="true" 说 明 本 身 是 在 父 类 容器 的 顶部 ;android: 
layout_centerHorizontal="true" 表 明 相 对 其 父 类 容器 居中 ; 

17 一 23 行 ， 定义 了 一 个 Button2。 其 中 ，android:layout_ 
below="@id/button1" 这 句 代 码 来 指定 Button2 在 Buttonl 下 面 。 

通过 DroidDraw 可 以 看 到 效果 如 图 2.23 所 示 。 

这 里 顺带 提 下 Android 开发 中 的 布局 属性 , 第 一 类 是 相对 
类 型 的 属性 , 意思 是 指 相对 于 父 类 元 素 或 者 当前 的 布局 , 比如 : 
android:layout_centerHrizontal 水 平 居中 ，android:layout 
alignParentBottom 贴 紧 父 元 素 的 下 边缘 。 当 然 相 对 类 型 的 属性 
可 以 通过 指定 ID 来 实现 ,就 像 上 面 例子 中 的 代码 那样 , 比如 : 
android:layout toLeftOf 表示 在 某 元 素 的 左边 ，android:layout 图 2.23 相对 布局 的 效果 
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alignLeft 表示 本 元 素 的 左边 缘 和 某 元 素 的 左边 缘 对 齐 ; 第 二 类 是 绝对 类 型 的 属性 ， 意 思 是 
属性 值 是 具体 的 像素 值 ， 可 以 用 dp、px 来 作为 单位 ， 比 如 : android: layout_marginBottom 
表示 离 某 元 素 底 边 缘 的 距离 ，android:layout marginTop 表示 离 某 元 素 上 边缘 的 距离 。 

除了 以 上 方法 外 还 有 很 多 类 似 的 方法 ， 就 不 一 一 列举 了 ， 这 些 方 法 都 可 以 在 相应 的 
SDK 文档 中 看 到 .可 以 参照 Android Layouts 说 明 , 网 址 为 http://developer.android.com/guide/ 
topics/ui/declaring-layout.html。 


2.3.6 ”分 而 治之 一 一 切换 卡 “TabWidget) 


切换 卡 〈TabWidget) 是 一 种 控件 ， 通 过 多 个 标签 来 切换 显示 不 同 的 内 容 ， 这 有 点 像 
C# 中 的 TabControl 控件 ,一 个 TabWidget 主要 是 由 一 个 TabHost 来 存放 多 个 Tab 标签 容器 ， 
再 在 Tab 容器 中 加 入 其 他 控件 , 通过 addTab 方法 可 以 增加 新 的 Tab。 这 些 除了 在 xml 文件 
中 布置 好 控件 外 ， 当 然 还 需要 在 Java 文件 中 处 理 好 事件 的 逻辑 。TabHost 继承 自 
FrameLayout， 是 帧 布局 的 一 种 ， 其 中 可 以 包含 多 个 布局 。 下 面 是 一 个 使 用 TabWidget 模仿 
网 上 商店 的 小 例子 。 

(1) 首先 新 建 一 个 名 为 myTabwidget 的 工程 ， 选 择 2.2 版 本 的 SDK， 新 建 完 成 后 ， 会 
得 到 如 图 2.24 所 示 的 工程 。 


日 四 wyTabwidget 
日 四 re 
日 机 com.L.mytabwidget 
由 [DD NyTsbwidgetActivity. java 
3 gm [Generated Java Files] 
EB hndroid 2.2 
ED assets 
DD bin 
已 也 res 
由 CS renable-hdpi 
HG drawable-ldpi 
HG rawsble-ndpi 
SB layout 
加 main xml 
Cfralues] 
9 Androi 明 anifest.xml 
© proguard cfg 
project. properties 











图 2.24 新 建 工程 


(2) 在 其 中 的 main.xml 中 重新 写 入 以 下 代码 : 


01 <?xml version="1.0" encoding="utf-8"?> 
02 <TabHost android:id="@+id/tabhost" 


03 xmlns:android="http://schemas.android.com/apk/res/android" 

04 android:orientation="vertical" // 表 示 布 局 是 垂直 的 ， 控 件 将 垂直 排列 
05 android:layout width="fill parent" 

06 android:layout height="fill parent"> 

07 <RelativeLayout 

08 android:orientation="vertical" // 表 示 布 局 是 垂直 的 ， 控 件 将 垂直 排列 
09 android:layout width="fill parent" 

10 android:layout height="fill parent"> 

11 <TabWidget 

12 android:id="@android:id/tabs" 
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3 
14 
15 


16 
Eh 
18 
下 和 
20 
区 二 
Pi 
2 
24 
FA 
26 
和 
28 
之 汪 
30 
32 
33 
34 
35 
36 
号 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
Es 
52 
53 


android:layout width="fil1 Parent" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" /> 
// 表 示 控 件 保持 在 父 类 容器 的 底部 
<FrameLayout 
android:id="@android:id/tabcontent" 
android:layout width="fill parent" 
android:layout height="fill parent"> 
<LinearLayout android:id="@+id/tabl" 
android:layout width="fill parent" 
android:layout height="fill parent" 
androidrientation="vertical"> // 定 义 布局 是 午 直 的 
<TextView 
android:id="e+id/view1l" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 电 影 列 表 : " 
J 
</LinearLayout> 
<LinearLayout android:id="@+id/tab2" 
android:layout width="fill parent" 
android:layout height="fill parent" 
androidrientation="vertical"> 
<TextView android:id="@+id/view2" 
android:layout width rap Content" 
android:layout height="wrap content" 
android:text=" 音 乐 列表 : " 
/> 
</LinearLayout> 
<LinearLayout android:id="@+id/tab3" 
android:layout width="fill parent" 
android:layout height="fill Parent" 
androidrientation="vertical"> 
<TextView android:id="@+id/view3" 
android:layout width="wrap content" 
android:layout height="wrap_content" 
android:text=" 书 籍 列表 : " 
> 
</LinearLayout> 
</FrameLayout> 
</RelativeLayout> 
</TabHost> 











(3) 在 自己 手动 写 TabHost 的 代码 时 ，TabHost、TabWidget、FrameLayout 的 ID 必须 
分 别 为 @android:id/tabhost 、 @android:id/tabs 、 (@android:id/tabcontent 。 并 且 注 意 到 
LinearLayout 的 布局 是 垂直 的 Vertical， 以 上 代码 是 一 个 TabHost 中 布局 了 一 个 Tabwidget， 
在 Tabwidget 中 使 用 的 是 帧 布局 (FrameLayout) ， 在 FrameLayout 中 布置 了 3 个 Tab( 标 
签 ) ， 每 个 标签 的 布局 是 LinearLayout (垂直 线性 的 ) 。 

(4) 在 2.24 图 中 src 文件 下 的 MyTabWidgetActivity.java 中 重新 写 入 以 下 代码 : 


01 
02 
03 
04 
05 
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06 

07 public class MyTabwidgetActivity extends Activity { 

08 public void onCreate (Bundle icicle) { 

09 super.onCreate (icicle); 

10 setContentView(R.layout.main); // 使 用 main.xml 中 的 文件 作为 主要 布局 

和 TabHost tabs = (TabHost) findViewById(R.id.tabhost); 
// 控 件 与 资源 ID 绑 定 

12 tabs .setup () 

13 TabHost.TabSpec spec = tabs.newTabSpec("this is 1st tab") 
// 初 始 显示 

14 spec.setContent (R.id.view1) : // 显 示 内 容 

15 spec.setIndicator ("Movie"); // 初 始 显示 的 一 个 Tab 名 称 

16 

ny // 如 果 需 要 带 icon 图 标 ， 则 使 用 setIndicator(CharSequence label, Drawable icon) 函 数 

18 

19 tabs.addTab (spec); // 添 加 第 二 个 Tab 

20 spec = tabs.newTabSpec ("this is 2nd tab"); 

2 spec.setContent (R.id.view2); 

区 这 spec.setIndicator ("Music"); 

| tabs.addTab (spec); 

24 spec = tabs.newTabSpec ("this is 3rd tab"); 

25 spec.setContent (R.id.view3); 

26 spec.setIndicator ("Book"); 

wh tabs.addTab (spec); 

28 setTitle("Online Market"); 

29 

30 // 启 动 时 显示 第 一 个 标签 页 

三 

32 tabs .setCurrentTab (0) ; // 选 择 第 一 个 Tab 作为 控件 初始 化 时 显示 的 Tab 

33 } 

34 } 


其 中 ，11 行 ，TabHost tabs= (TabHost) findViewById(R.id.tabhost) 声 明了 一 个 TabHost; 

13 行 ， 声 明了 一 个 新 的 标签 ， 名 为 “this is lst tab”; 

14 行 ， 是 将 新 声明 的 Tab 和 我 们 在 xml 文件 中 写 好 的 Textview1l 进行 绑 定 ， 这 样 再 单 
击 这 个 Tab 的 时 候 ， 内 容 就 是 Textview1l 的 内 容 了 ; 

15 行 ， 是 将 刚刚 设 定好 的 Tab 显示 成 “Movie”; 

19 一 27 行 ， 类 似 地 添加 了 另外 两 个 选项 卡 : Music 和 Book; 

28 行 ， 设 置 标题 显示 内 容 ; 

32 行 ， 设 置 当 该 界面 创建 时 显示 的 标签 页 ， 这 里 显示 第 一 个 。 

做 好 以 上 工作 后 在 模拟 器 中 运行 以 上 代码 ， 可 以 得 到 如 图 2.25 所 示 的 结果 。 当 然 我 们 
可 以 任意 单 击 底部 的 标签 ， 可 以 发 现 确实 可 以 进行 切换 ， 如 图 2.26 所 示 。 








2.3.7” 犹 抱 酝 琶 半 遮 面 一 一 滚动 视图 (ScrollView) 

当 一 页 内 容 太 多 ， 显 示 不 完 时 ， 可 以 利用 滚动 视图 (ScrollView) 来 实现 ， 最 常见 的 
例子 就 是 书籍 阅读 器 ， 一 本 书 内 容 太 长 ， 我 们 可 以 滚动 屏幕 来 显示 余下 的 内 容 。 下 面 我 们 
通过 一 个 模仿 书籍 目录 的 例子 来 简单 看 下 如 何 使 用 滚动 视图 (ScrollView) 。 同 样 地 我 们 
新 建 一 个 工程 ， 新 建 方法 可 以 参照 之 前 的 例子 , 在 主 视图 的 布局 文件 main.xml 中 重新 写 入 
以 下 代码 : 
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图 2.25 网 上 


商店 的 效果 


<?xml Version="1.0"” encoding="utf-8"?> 
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android" 
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android:layout 
android:layout 


width="fill parent" 
height="fill parent" 


android:scrollbars="vertical" > 


<LinearLayout 


android:layout width="fill parent" 
android:layout height="fill parent" 
android:orientation="vertical" > 


<TextView 
android: 
android: 
android: 
android: 


<TextView 
android: 
android: 
android: 
android: 


<TextView 
android: 
android: 


layout width="100dp" 
layout height="70dp" 





图 2.26 





切换 标签 


// 表 示 视 图 是 垂直 的 


// 线 性 布局 是 垂直 的 


layout gravity="center horizontal" 


text=" 第 一 部 分 "/> 


layout width="100dp" 
layout height="70dp" 
layout gravit 
text=" 第 二 部 分 "/> 








layout width 
layout height 


00gdp" 
"70dp" 


"center horizontal™" 


android:layout gravity="center horizontal" 


android: 


<TextView 
android: 
android: 


text=" 第 三 部 分 "/> 


layout width="100dp" 
layout height="70dp" 





android:layout gravity="center horizontal" 


android: 





text=" 第 四 部 分 "/> 
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<TextView 
android:layout width: 00dp" 
android:layout height="70dp" 
android:layout gravity="center horizontal" 
android:text=" 第 五 部 分 "/> 





<TextView 
android:layout width="100dp" 
android:layout height="70dp" 
android:layout gravity="center horizontal" 
android:text=" 第 六 部 分 "/> 


<TextView 
android:layout width="100dp" 
android:layout height="70dp" 
android:layout gravity="center horizontal" 
android:text=" 第 七 部 分 "/> 





<TextView 
android:layout width: 00gp" 
android:layout height="70dp" 
android:layout gravity="center horizontal" 
android:text=" 第 八 部 分 "/> 





<TextView 
android:layout width="100dp" 
android:layout height="70dp" 
android:layout gravity="center horizontal" 
android:text=" 第 九 部 分 "/> 
</LinearLayout> 








</ScrollView> 


之 后 运行 这 个 程序 ， 可 以 看 到 如 图 2.27 所 示 的 效果 。 上 下 翻动 页 面 ， 如 图 2.28 那样 
可 以 显示 没有 在 第 :完全 的 部 分 。 
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图 2.27 ”滚动 视图 
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2.3.8 列表 (ListView) 


列表 (ListView) 是 Android 界面 开发 中 常用 到 的 组 件 ， 
它 通 过 列表 的 形式 展现 内 容 , 其 中 的 子 元 素 能 够 自 适应 长 度 显 
示 。 列 表 通 常 有 以 下 两 个 元 素 : 一 是 供 显示 用 的 View， 二 是 
适配器 (Adapter) 。 适 配器 是 用 来 将 图 片 、 数 据 或 者 控件 组 织 国富 
起 来 ,形成 一 个 模板 , 而 ListView 中 每 个 子 元 素 都 按照 这 个 模 国生 
板 来 生成 。 
下 面 我 们 来 实现 一 个 例子 , 使 用 ListView 来 模仿 手机 中 的 
通信 录 的 实现 ， 显 示 效 果 如 图 2.29 所 示 。 
在 实现 ListView 时 ， 我 们 需要 进行 如 下 几 步 来 完成 : 
(1) ListView 整体 布局 图 2.29 “ListView 的 效果 
我 们 新 建 一 个 名 为 MyListView 的 工程 ,在 main.xml 文件 
我 们 加 入 一 个 ListView 控件 ， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
// 定 义 命名 空间 
android:id="@+id/LinearLayout01" 
android:layout width="fill parent" 
android:layout height="fill parent" > 





China Mobile 








中 


<ListView 
android:id="@+id/MyListView" 
android:layout width="wrap content" 
android:layout height="wrap content" > 
</ListView> 


</LinearLayout> 


这 段 代 码 比较 简单 ， 就 是 在 一 个 线性 布局 中 加 入 一 个 列表 。 
(2) 显示 项 布局 
然后 我 们 需要 设置 适配器 的 布局 , 这 里 用 到 的 是 SimpleAdapter, 我 们 在 工程 中 的 layout 
这 个 文件 夹 下 新 建 一 个 名 为 list_adapter.xml 的 文件 ， 如 图 2.30 所 示 。 
Listyier 


由 - 吕 gen [Generated Java Files] 
由 柄 jndroid 2.2 





出 GE renable-hdpi 
HB rarble-ldpi 
BG rersble-ndpi 
BB lyout 

0 list_adapter, xml 


HG values 

3 Mndroilanifest. xml 
yepurd fe 
project. properties 


图 2.30 新 建 第 二 个 布局 文件 
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我 们 在 这 个 布局 中 需要 实现 的 是 左边 两 行 分 别 显示 联系 人 的 姓名 和 电话 号 码 ， 右 边 是 
头像 。 布 局 的 实现 代码 如 下 : 


<?xm] version="1.0" encoding="utf-8"?> 
<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android"// 定 义 命名 空间 
android:id="@+id/RelativeLayout01" 
android:layout width="fil1 parent" 
android:layout height="wrap content" 


android:paddingBottom="4dip" // 定 义 控件 距离 底部 的 距离 
android:paddingLeft="12dip" // 定 义 控件 距离 左边 的 距离 
android:paddingRight="12dip" > // 定 义 控件 距离 右边 的 距离 


<ImageView 
android:id="@+id/ItemImage" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout alignParentRight="true" 
android:paddingTop="12dip" /> 


<TextView 
android:id="@+id/ItemName" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="TextView01" 
android:textSize="20dip" /> 


<TextView 
android:id="@+id/ItemNumber" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:1layout below="@+id/ItemName" 


// 定 义 控件 在 另外 一 个 控件 之 下 ， 通 过 id 指定 


android:text="TextView02" /> 


</RelativeLayout> 


这 段 代码 中 使 用 了 相对 布局 (RelativeLayout) ， 一 般 
适配器 中 也 推荐 使 用 相对 布局 。 在 布局 中 有 3 个 控件 ， 分 
别 是 图 片 (ImageView) 和 两 个 文字 显示 区 (TextView) 。 其 
中 图 片 (ImageView) 通 过 代码 android:layout_alignParentRight= 
"true" 来 指定 它 位 于 父 类 容器 ， 即 整个 布局 的 右 侧 。 第 一 个 
TextView 的 宽度 通过 android:layout_width="fill parent" 这 
名 代码 来 标明 ， 这 个 子 元 素 的 宽度 和 父 类 元 素 的 宽度 保持 
一 致 ， 在 第 二 个 TextView 中 通过 代码 android:layout below= 
"@+ id/ItemName" 来 指定 它 是 位 于 第 一 个 TextView 的 正 
太志 3 

之 后 我 们 在 res/drawable-ldpi 文件 中 复制 一 张 后 级 名 
为 png 格式 的 图 片 ， 将 它 命名 为 haipng， 图 片 内 容 不 限 ， 
我 们 用 这 张 图 片 来 模拟 用 户 联系 人 的 图 片 ,如 图 2.31 所 示 。 

在 其 他 两 个 图 片 文件 夹 res/drawable-hdpi 和 
res/drawable-mdpi 中 加 入 图 片 效果 也 一 样 ， 这 里 只 是 人 为 


日 蔬 WyListyiey 


日 四 re 
日 机 com.L.mylistview 
由 四 MyListViewActivity. java 
由 gen [Generated Java Files] 
BR Android 2.2 
EE assets 
由 bin 
日 己 res 
GE drawable-hdpi 
SG rawsble-ldpi 
日 
加 ic_launcher. png 
HG rawable-ndpi 
SG layout 
的 list_adapter. xml 
DO main. xml 
EG values 
9 Androi Manifest. xml 
下 proguard. cfe 
project. properties 


图 2.31 新 加 入 图 片 
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地 按 分 辩 率 对 图 片 进行 分 类 ，3 个 文件 夹 分 别 对 应 高 、 中 和 低 的 分 辩 率 。 
(3) 数据 适 配 
有 了 显示 的 界面 ,然后 就 需要 提供 给 界面 具体 的 显示 数据 。 在 Java 文件 中 实现 ， 代 码 


如 下 : 


package com.L.mylistview; 


import 
import 


import 
import 
import 
import 


public 


java.util.ArrayList; 
java.util.HashMap; 


android.app.Activity; 
android.os.Bundle; 
android.widget .ListView; 
android.widget.SimpleAdapter; 


class MyListViewActivity extends Activity { 


/** Called when the activity is first created. */ 
public void onCreate (Bundle savedInstanceState) { 


} 


super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


ListView list = (ListView) findViewById(R.id.MyListView); 
// 控 件 与 资源 绑 定 


// 往 map 中 填充 数据 
ArrayList<HashMap<String, Object>> listItem = new ArrayList 
<HashMap<String, Object>>(); 
Bor (dint ios O08 Ls 
HashMap<String, Object> map = new HashMap<String, Object>(); 
map.put ("Image",，R.drawable.hai) ;// 按 照 “ 键 ”和 “ 值 ” 装 入 数据 
map.put ("Name", "China Mobile"); 
map.put ("Number", "10086"); 
listItem.add (map); // 添 加 map 到 1ist 中 


上 

// 构 造 适 配器 

SimpleAdapter listItemAdapter = new SimpleAdapter (this, listItem, 
R.layout.list adapter, 
new String[] { "Image", "Name", "Number" }, 
new int[] { R.id.ItemImage, R.id.ItemName, R.id. 
ItemNumber }); 


list.setAdapter (listItemAdapter); 


其 中 ，17 行 ， 声 明 一 个 名 为 list 的 ListView 控件 ， 并 通过 ID 绑 定 到 刚刚 在 main.xml 
文件 中 所 声明 的 ListView 的 控件 ; 

20 行 ， 声 明 一 个 名 为 listItem 的 ArrayList 数组 ， 数 组 的 每 一 个 元 素 是 一 个 HashMap 
键 值 对 ，HashMap 存储 的 类 型 是 一 个 键 名 (String 类型) 对 应 一 个 键 值 (Object 类 型 ) 。 

21 一 27 行 ， 通 过 For 循环 重复 往 listItem 中 存储 元 素 ， 存 储 的 对 象 是 一 个 Map，Map 
中 依次 是 联系 人 的 图 片 、 联 系 人 的 名 称 和 联系 人 的 号 码 。 其 中 ，23 行 ， 是 在 Map 中 存放 
图 片 , Rdrawable hai 是 该 图 片 的 资源 名 。 在 这 里 我 们 为 了 方便 , 填充 的 是 自己 伪造 的 数据 ， 
并 没有 真正 读 取 手 机 中 的 联系 人 信息 ， 在 Android 中 读 取 手机 联系 人 的 信息 实际 上 是 读 取 
Android 自 带 的 ContentProvider 中 一 个 URI， 本 书后 面 的 章节 会 详细 地 讲述 。 
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29 一 32 行 ， SimpleAdapter listItemAdapter = new SimpleAdapter(this, listItem, 
R.layout.list_adapter, new String[] { "Image", "Name", "Number" },new int[] { R.id.ItemImage, 
R.id.ItemName，R.id.ItemNumber }) 这 句 代 码 是 使 用 SimpleAdapter 适配器 将 刚刚 的 
list_adapter.xml 文件 的 模板 绑 定 ， 这 个 函数 的 第 二 个 参数 表示 数据 来 源 ， 这 里 我 们 的 数据 
来 源 是 之 前 的 listItem 数组 ， 第 三 个 参数 是 ListView 中 子 元 素 的 xml 实现 ， 第 四 个 和 第 五 
个 参数 是 将 Map 中 的 字段 与 资源 文件 中 的 资源 名 相对 应 。 

Android 中 除了 简单 适配器 SimpleAdapter 之 和 ， 还 有 ArrayAdapter 和 
SimpleCursorAdapter 两 种 适配器 。 其 中 ArrayAdapter 只 能 用 来 显示 一 行 字 ， 而 
SimpleCursorAdapter 是 为 了 配合 查询 Android 的 数据 库 ea 可 以 很 方便 地 把 数据 库 中 
的 内 容 显示 出 来 。 

做 完 以 上 工作 后 ， 我 们 运行 这 个 程序 ， 就 可 以 看 到 如 图 2.29 所 示 的 结果 。 





2.4 Android 中 综合 界面 实例 


上 一 节 我 们 只 是 对 一 些 常用 的 布局 进行 总 结 和 简单 应 用 ， 接 下 来 的 这 一 节 我 们 会 对 
综合 性 的 界面 ， 比 如 九宫 格 、popupwindows， 举 一 些 例子 来 使 用 。 


2.4.1 登录 界面 


我 们 从 最 简单 的 登录 界面 开始 举例 ， 登 录 界 面 一 般 包括 用 户 名 和 密码 输入 框 ， 登 录 按 
钮 和 其 他 一 些小 的 控件 。 在 本 示例 中 ， 我 们 将 实现 的 用 户 登录 界面 如 图 2.32 所 示 。 


总 而 色 2:47 pu 





图 2.32 简单 的 登录 界面 
接 下 来 ， 我 们 逐步 来 实现 这 个 综合 的 界面 布局 。 
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我 们 先 来 设计 一 个 原形 ， 运 行 Eclipse， 新 建 - 
修改 main.xml, 一 般 来 说 为 了 更 好 的 兼容 性 ， 我 人 





-个 工程 ， 在 工程 的 res/layout 文件 夹 中 
将 根 布局 改 为 RelativeLayout， 默认 情况 





下 新 工程 根 布局 为 垂直 线性 布局 。 布 局 改 好 后 代码 刀 


下 : 


<?Xxml version="1.0" encoding="utf-8"?> 
<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/RelativeLayoutl1" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:orientation="vertical" > 
</RelativeLayout> 


首先 我 们 需要 一 个 ImageView 来 显示 软件 的 图 片 ， 一 个 TextView 来 显示 软件 名 称 ， 
我 们 在 xml 布局 中 加 入 这 两 个 控件 ,在 Eclipse 的 开发 环境 下 , 可 以 在 xml 文件 的 Graphical 
Layout 模式 下 拖 动 控件 到 布局 中 , 快速 进行 开发 。 本 例 在 Eclipse Helios 和 ADT 14 版 本 下 
开发 ， 如 图 2.33 所 示 。 
© Mndroid Development Toolkit 


Version: 14.0.0.v201110171935-205994 


(e) Copyright 2007-2011 The Android Open Source Froject. All rights reserved| 
Visit http’//developer, android. com/sdk/eclipse-adt. htnl 


图 2.33 


ADT 版 本 为 14 


在 xml 文件 编写 界面 的 左下 角 可 以 单 击 Graphical Layout 按钮 实现 xml 文本 和 即 见 即 
得 的 界面 的 切换 ， 如 图 2.34 所 示 。 


后 Forn Widgets 





DD Text Fields 


DD Layouts 
Composite 

DD Inages & Nedia 
DTine & Date 
DD Transitions 


OD Mvanced 





Custom & ..ary Yiews 
国 Graphiesl Layout 三 main xnl 


图 2.34 


左下 角 的 按钮 可 以 切换 视图 
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在 上 图 中 我 们 还 看 到 ， 左 边 是 分 类 好 的 控件 ， 右 边 是 当前 xml 文件 对 应 的 布局 界面 。 
我 们 在 左 侧 Image&Media 分 类 下 , 选择 第 一 个 控件 ImageView 拖 放 到 界面 中 间 , 修改 它 的 
属性 ， 使 它 在 水 平方 向 上 居中 ， 并 离 界面 顶端 70dp。 再 在 Form Widgets 分 类 下 选择 第 一 个 
控件 TextView 拖 放 到 布局 中 ， 修 改 它 的 属性 使 它 居于 ImageView 的 下 端 ， 水 平方 向 上 仍 
然 居中 ， 此 时 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/ 
android" 
android:id="e+id/RelativeLayout1" 
android:layout width="fill parent" 


android:layout height="fill parent" 
android:orientation="vertical" > 











<TextView 
android:id="@+id/textViewl" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout below="@+id/imageViewl" 
android:layout centerHorizontal="true" 
android:text="xx 软件 " /> 


<ImageView 
android:id="@+id/imageViewl1" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerHorizontal="true" 


android:layout marginTop="70dp" // 定 义 控件 距离 项 部 的 距离 
android:src="@drawable/a" /> // 定 义 控件 使 用 图 片 ， 通 过 id 指定 
</RelativeLayout> 


上 面 代码 中 的 android:src="@drawable/a" 将 ImageView 的 图 片 设 为 图 a, 图 片 我 们 已 经 
事先 放 在 工程 文件 夹 res/layout/drawable-hdpi 下 ， 名 为 apng。 然 后 我 们 需要 两 个 EditText 
可 编辑 的 输入 框 ， 来 让 用 户 输入 账号 和 密码 。 它 们 都 在 水 平方 向 上 居中 ， 并 在 刚刚 的 
TextView 控件 的 下 端 ， 并 且 初 始 时 显示 “账户 ”和 “密码 ”， 以 提示 用 户 输入 。 做 完 以 上 
工作 后 代码 如 下 : 

<?xml Version="1.0" encoding="utf-8"?> 
<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/RelativeLayout1" 
android:layout width="fill parent" 


android:layout height="fill parent" 
android:orientation="vertical" > 


<TextView 
android:id="@+id/textViewl™" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout below="e+id/imageView1" 
android:layout centerHorizontal="true" 
android:text="xx 软件 " /> 


<ImageView 
android:id="@+id/imageViewl1™" 
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android:layout width="wrap content" 
android:layout height="wrap Content" 
android:layout centerHorizontal="true"™ 
android:layout marginTop="70dp" 
android:src="@drawable/a" /> 


<EditText 
android:id="@+id/editText1" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout below="@+id/textViewl" 
android:text=" 账 户 " /> 


<EditText 
android:id="@+id/editText2" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout below="@+id/editText1" 
android:text=" 密 码 "” /> 


</RelativeLayout> 


最 后 我 们 在 根 布局 底部 加 上 两 个 按钮 分 别 显示 “登录 ”和 “ 返 


<Button 

android:id="e+id/button1" 
layout width="wrap_content" 
layout height="wrap_content" 
layout alignParentBottom="true" 
android:layout alignParentLeft="true" 
android:text=" 登 录 " /> 








<Button 
android:id="@+id/button2" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:layout alignParentRight="true" 


android:text=" 返 回 " /> 


有 些 登 录 界面 ， 在 “密码 ”输入 框 的 下 端 ， 我 们 经 常 看 到 “ 记 住 


回 ” 





: 
主 秘 


。 代 码 如 下 : 


密码 ” 和 oi 自动 登录 4 


两 个 可 供 勾 选 的 控件 ， 这 在 Android 中 可 以 用 CheckBox 控件 来 实现 ， 最 后 代码 如 下 : 


<?xml] version="1.0" encoding="utf-8"?> 
<RelativeLayout 










="@+id/RelativeLayout1" 
ayout width="fill parent" 
layout height="fill parent" 
android:orientation="vertical" > 


<TextView 
android:id="@+id/textViewl" 
android:layout width=" vi Content" 
android:layout height="wrap content™" 
android:layout below="@+id/imageViewl™" 
android:layout centerHorizontal="true" 
android:text="xx 软件 " /> 
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<ImageView 
android:id="e@+id/imageView1" 
android:layout width="wrap content" 
android:layout height="wrap content™" 
android:layout centerHorizontal="true"™" 
android:layout marginTop="70dp" 
android:src="@drawable/a" /> 


<EditText 
android:id="@+id/editText1" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout below="@+id/textViewl" 
android:text=" 账 户 " /> 


<EditText 
android:id="@+id/editText2" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout below="@+id/editText1" 
android:text=" 密 码 " /> 


<Button 
android:id="@+id/buttonl" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:layout alignParentLeft="true" 
android:text=" 登 录 " /> 





<Button 
android:id="@+id/button2" 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:layout alignParentRight="true" 
android:text=" 返 回 " /> 


<CheckBox 
android:id="@+id/checkBox1" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout below="@+id/editText2" 
android:layout toLeftOf="@+id/imageView1" 
android:text=" 记 住 密码 ” /> 


<CheckBox 
android:id="@+id/checkBox2" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout below="e+id/editText2" 
android:layout toRightOf="@+id/textViewl" 
android:text=" 自 动 登录 "” /> 


</RelativeLayout> 


通过 这 样 的 布局 ， 我 们 就 实现 了 登录 界面 ， 其 效果 如 图 2.32 所 示 。 
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2.4.2 体重 计算 器 


我 们 都 知道 在 Android 中 一 个 xml 通常 对 应 一 个 活动 的 界面 ， 界 面 之 间 的 跳 转 和 界面 
内 控件 的 协作 都 交 给 对 应 的 Java 文件 来 控制 。 通 常 在 界面 跳 转 时 ， 我 们 可 能 需要 上 一 个 界 
面 的 数据 和 输出 来 作为 下 一 个 界面 的 输入 。 下 面 通过 一 个 简单 的 例子 一 一 体重 计算 器 ， 来 学 
习 通过 使 用 Bundle 在 不 同 界面 间 传 递 简单 数据 , 并 且 学 习 一 组 新 的 常用 控件 :RadioButton。 
体重 计算 器 的 界面 设计 如 图 2.35 所 示 。 


Myapp 








计算 你 的 标准 体重 


(“HeE 





图 2.35 体重 计算 器 界面 


首先 我 们 了 解 到 ， 男 性 的 标准 体重 公式 大 概 是 : (身高 (cm)-80)X0.7， 而 女性 的 标准 体 
重 公式 大 概 是 : (身高 (cm)-70)X0.6。 这 时 的 需求 是 ， 程 序 需要 用 户 选择 自己 的 性 别 ， 并 输 
入 自己 的 身高 ， 我 们 肯定 需要 一 个 EditText 可 编辑 框 ， 让 用 户 来 输入 。 
另外 ， 性 别 只 能 选择 一 种 ， 也 就 说 不 能 用 两 个 CheckBox 来 完成 ， 这 需要 在 Java 文件 
中 写 好 逻辑 ， 即 不 能 同时 选中 两 个 CheckBox， 这 时 最 好 使 用 RadioButton 。 
(1) 主 界面 布局 
新 建 一 个 工程 ， 在 main 中 重新 写 入 以 下 代码 : 
<?xml] version="1.0" encoding="utf-8"?> 
<AbsoluteLayout xmlns:android="http://schemas.android.com/apk/res/ 
android" 
android:id="@+id/widget0" 
android:layout width="fill parent" 
android:layout height="match parent"> 
<TextView 
android:id="@+id/showtext" 
android:textSize="25sp"” // 定 义 控件 字体 的 大 小 
android:layout width="wrap content" 
android:layout height="26px" 
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android:layout x: 
android:layout y= 





"65px" 
"21px" 


android:text=" 计 算 你 的 标准 体重 " 


/> 
<TextView 
android:id="@+id/ 
android:layout wi 
android:layout he 
android:1layout . 
android:1layout : 






text sex" 
dth="wrap_content" 
ight="wrap content" 
"71pxn 

"103px" 


android:text=" 性 别 :" 







/> 

<TextView 
android:id="@+id/ 
androi ayout wi 
android:layout he 
android:layout x 


android:1layout 


text Height" 
dth="wrap content" 
ight="wrap Content" 





android:text=" 身 高 :" 


/> 
<RadioGroup 

android:id="@+id/ 
layout wi 
layout he 
orientati 
layout x 
android:layout y= 
<RadioButton 





radiogroup" 
dth="wrap content" 
ight="37px" 
on="horizontal" 
"124pr" 

“01PZ" > 








android:id="@+id/Sex Man" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 男 "> 


</RadioButton> 
<RadioButton 


android:id="@+id/Sex Woman" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 女 "> 






</RadioButton> 
</RadioGroup> 
<EditText 
android:id="@+id/ 
android:layout wi 
android:layout he 
android:text="" 


android:textSize= 
android:1layout . 
android:layout y= 
/> 

<Button 





height Edit"™" 
dth="123px" 
ight="wrap_content" 


"18sp" 
2 
"160px" 


android:id="@+id/button ok" 
android:layout width="80px" 


android:layout he 


ight="wrap content" 


android:text=" 计 算 " 





layout x= 
android:layout y= 
/> Ky 

</AbsoluteLayout> 


以 上 代码 中 可 以 看 出 使 月 


"125px" 
"263px" 





日 的 是 绝对 布局 ， 在 使 用 RadioButton 


时 需要 在 控件 外 部 加 上 
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RadioGroup， 以 表明 两 个 RadioButton 是 一 组 的 。 


(2) 数据 获取 





在 主 界面 中 ， 我 们 需要 获取 性 别 以 及 身高 ， 并 将 数据 传递 给 计算 显示 界面 。 具 体 实现 


如 下 : 


01 package com.test; 


03 import android. 
04 import android. 
05 import android. 
06 import android. 
07 import android. 
08 import android. 


app.Activity; 
content.Intent; 
os.Bundle; 
View.View; 
widget .Button; 
widget.EditText; 


09 import android.widget.RadioButton; 

10 

11 public class Main extends Activity { 

bh /** Called when the activity is first created. */ 

4 @Override 

14 public void onCreate (Bundle savedInstanceState) { 
15 super.onCreate (savedInstanceState); 

16 setContentView (R.layout .main); 

i Button ok=(Button) findViewById(R.id.button ok); 
18 ok.setonClickListener (new View.OnClickListener() {// 添 加 点 击 事件 
19 public void onClick(View arg0) { 

20 // TODO Auto-generated method stub 


bl EditText et=(EditText)findViewById(R.id.height Edit); 

人 2 double height=Double.parseDouble (et .getText () . 
tostring()); 

3 String sex=""; 

24 

25 //RadioButton 中 的 一 个 ， 用 来 判断 勾 选 情况 

26 RadioButton rbl=(RadicButton) findViewById(R.id.Sex Man) 

27 if(rbl.isChecked()) 

28 { 

29 sex="M"; 

30 } 

31 else 

32 { 

33 Sex="F"; 

34 } 

9 Intent intent=new Intent () ; 

36 intent .setClass (Main.this, BgActivity.class); 

37 // 在 Bundle 中 放 入 数据 ， 使 用 “ 键 ”-“ 值 ”对 的 形式 存放 

38 Bundle bundle=new Bundle(); 

39 bundle.putDouble ("height", height); 

40 bundle.PutString("sex" ,sex) : 

41 intent.PutExtras (bundle) : 

42 startActivity (intent) : 

43 } 

44 1D); 

45 } 

46 } 


其 中 ，26 一 27 行 ， 获 取 RadioButton 选择 控件 ， 并 通过 其 是 否 被 选择 判断 性 别 ; 

35 一 40 行 ， 将 本 界面 中 获取 的 性 别 、 身 高 等 信息 传递 给 计算 显示 界面 。 其 中 36 行 是 
声明 一 个 Intent 意图 ， 为 的 是 从 Main 跳 转 到 BgActivity; 

38 一 40 行 , 声明 了 一 个 Bundle, 通过 bundle.putDouble("height", heighb 方法 向 Buddle 
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中 添加 一 个 Double 类 型 的 数据 ， 名 为 height; 通过 
bundle.putString("sex",sex) 方 法 向 Buddle 中 再 放 入 一 个 String 
型 的 数据 ; 在 Buddle 是 按照 “ 键 ”-“ 值 ”对 的 方式 来 存储 的 ， 
所 以 在 取出 Buddle 中 的 数据 时 ， 根 据 “ 键 ”名 就 可 以 获取 数 
据 了 ; 

41 一 42 行 , 向 意图 中 添加 数据 并 进行 界面 间 的 跳 转 。 其 中 ， 
41 行 表示 在 Intent 中 加 入 已 经 放 好 数据 的 Buddle。42 行使 用 
startActivity 开启 跳 转 。 对 于 Activity 之 间 的 跳 转 ， 我 们 将 在 下 
一 章 中 进行 详细 的 讲解 。 

(3) 计算 显示 

在 工程 src 文件 夹 下 新 建 一 个 Java 文件 ， 用 来 计算 和 显示 
结果 ， 并 使 用 另 一 个 xml 文件 来 定义 显示 界面 。 工 程 结 构 如 图 
2.36 所 示 。 


已 册 co test 

由 回 Beketivity,java 

由 门 nain java 
由 -加 gen [Generated Javs Files] 
四 本 Android 2.2 


由 全 ranable-hdpi 
BD rarable-ldpi 
HD ransblendpi 
SB layonut 

main xml 

0 nylayout. xnl 
HG values 
AndroidMlanifest, xnl 
progurd cfe 
目 project. properties 


图 2.36 工程 结构 


在 显示 结果 界面 只 需要 一 个 TextView， 此 处 不 再 讲解 ， 如 图 2.37 所 示 。Java 文件 的 


计算 和 显示 代码 如 下 : 











01 package com.test; 

02 

03 import java.text.DecimalFormat; 

04 import java.text.NumberFormat; 

05 import android.app.Activity; 

06 import android.os.Bundle; 

07 import android.widget.TextView; 

08 

09 public class BgActivity extends Activityt{ 

10 public void onCreate (Bundle savedInstanceState){ 

直击 super.onCreate (savedInstanceState) 

12 setContentView(R.layout.mylayout); 

3 

14 // 此 处 通过 Bundle 获得 传递 过 来 的 数据 ， 以 键 名 来 获得 值 

15 

16 Bundle bundle=this .getIntent() .getExtras () 

17 String sex =bundle.getString("sex") 

18 double height=bundle.getDouble ("height") : 

19 String sexText=""; 

20 if(sex.equals ("M") ) 

2 { 

22 sexText=" 男 性 "; 

P| 1 

24 else { 

F sexText=" 女 性 "; 

26 } 

27 String weight=this.getWeight(sex,height); 

28 TextView tvl=(TextView)findViewById(R.id.text1); 

29 tv1 .setText ("你 是 一 位 "+sexText+"\n 你 的 身高 是 "+theight+" 厘 米 \n 你 的 
标准 体重 是 "+weight+" 公 斤 30 eh 

中 } 

EE Private String format(double num){ 

3 NumberFormat formatter=new DecimalFormat ("0.00"); 

34 String s=formatter.format (num); 

35 return s; 

36 } 

ED Private String getWeight(String sex,double height) { 
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38 String weight=""; 

39 if(sex.equals ("M") ) 

40 { 

41 weight=format ( (height-80)*0.7); 
42 } 

43 else 

44 { 

45 weight=format ( (height-70)*0.6); 
46 } 

47 return weight; 

48 } 

49 J} 


其 中 ，16 一 18 行 ， 从 上 一 个 界面 中 获取 数据 。 界 面 Activity 之 间 的 跳 转 ， 我 们 将 在 下 
- 章 中 有 详细 的 讲解 ; 

28 一 29 行 ， 显 示 介 绍 的 结果 ; 

37 一 48 行 ， 根 据 男女 性 别 的 选择 ， 计 算出 其 相应 的 体重 。 

运行 该 工程 ， 当 选择 男性 、 输入 身高 175 厘米 时 , 可 以 得 到 输出 结果 ,如 图 2.37 所 示 。 


2.4.3” 相 筹 


在 手机 应 用 开发 中 ， 我 们 经 常 
来 想 一 下 要 实现 一 个 相 敌 的 需求 。 

对 于 一 个 类 似 相框 的 东西 ， 在 Android 已 经 提供 这 种 控件 Gallery， 其 中 每 一 张 图 片 需 
要 用 ImageView 来 显示 , 而 每 一 个 ImageView 需要 一 个 Adapter 适配器 来 管理 。 在 本 节 中 ， 
我 们 通过 实现 相 簿 来 如 何 使 用 Gallery 和 Toast 提示 。 在 本 例 中 ,我 们 将 实现 的 相 短 效 
果 如 图 2.38 所 示 。 





看 到 一 些 制 作 精 美的 相 簿 用 来 显示 精美 的 图 片 。 我 们 先 











Mygallerytest 


SS 
| 





图 2.37 计算 结果 图 2.38 显示 了 3 张 图 片 的 Gallery 


(1) 界面 布局 
首先 新 建 一 个 工程 ， 在 main.xml 中 把 根 布局 去 掉 ， 加 上 控件 Gallery， 代 码 如 下 : 


<?2xml] version="1.0" encoding="utf-8"?> 
<Gallery xmlns:android="http://schemas.android.com/apk/res/android" 
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android:id="e@+id/gallery1" 3 yellerytest 
ayout width="match Parent" 时 名 让 ee 
android:layout height="wrap content" > Di 
由 [DD Nyeallerytesthctivity, java 
</Gallery> 由 -器 gm [Generated Javs Files] 


(2) 显示 图 片 

我 们 准备 4 张 图 片 ，3 张 在 相 短 中 显示 ，1 张 作 为 相框 的 背 
景色 。 本 例 中 ， 搜 集 了 4 张 320X480 的 大 图 ， 放 在 了 
res/drawable-hdpi 文件 夹 中 。 

(3) 显示 适配器 ensbleldpi 


HB dranable-ndpi 


我 们 再 来 写 自己 的 适配器 ， 在 src 文件 夹 中 新 建 一 个 新 的 BB lyont 












Java 文件 。 这 样 ， 我 们 添加 好 了 图 片 和 Java 文件 ， 其 工程 目录 。 sw 
EN AndroiMenifest, 
如 图 2.39 所 示 。 emt a 
在 Adapter image.java 中 写 入 代码 ， 需 要 重新 实现 Adapter es 
中 的 4 个 接口 ， 代 码 如 下 : 图 2.39 工程 结构 
01 package com.L.gallerytest; 
02 


03 import android.content.Context; 

04 import android.view.View; 

05 import android.view.ViewGroup; 

06 import android.widget.BaseAdapter; 
07 import android.widget.Gallery; 

08 import android.widget.ImageView; 


09 

10 public class Adapter image extends BaseAdapter{ 
11 

public Context myContext; 

9 public Integer[] imgArray= 

14 { 

5 R.drawable.photol, 

16 R.drawable.photo2, 

17 R.drawable .photo3 

18 }; 

19 public Adapter image (Context c) 

20 { 

21 myContext=c; 

22 } 

总 

24  //4 个 默认 接口 ， 都 需要 重 写 

25 

26 GOverride 

人 了 public int getCount() { 

28 // TODO Auto-generated method stub 
29 return imgArray.length; 

30 上 

31 

32 @Override 

33 Public Object getItem(int arg0) { 

34 // TODO Auto-generated method stub 
35 return imgArray[larg0]; 

36 } 

2 

38 @Override 

39 Public long getItemId(int position) { 
40 // TODO Auto-generated method stub 
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41 return position; 

42 } 

43 //getview 函数 用 来 显示 接口 ， 定 义 了 一 些 显 示 的 细节 

44 Q@Override 

45 Public View getView (int position, View convertView, ViewGroup Parent) { 
46 // TODO Auto-generated method stub 

47 ImageView imView=new ImageView (myContext) 

48 imView.setImageResource (imgArray [position]); 

49 imView.setLayoutParams (new Gallery.LayoutParams (160,240)); 
50 imView.setScaleType (ImageView.ScaleType.FIT CENTER); 

DE return imView; 

到 全 } 

53 

54 } 


在 以 上 代码 中 ， 声 明了 两 个 变量 ， 一 个 是 Context 类 型 的 myContext， 一 个 是 整 型 数 
组 imgArray， 用 来 存放 图 片 在 资源 文件 中 的 序号 ,并重 写 了 getCount、getItem、getItemId、 
getView 4 个 函数 。 

在 getView 函数 中 ， 声 明了 新 的 ImageView 控件 ， 并 且 通 过 代码 imView.setLayoutParams 
(new Gallery.LayoutParams(160,240)) 设 置 了 图 片 以 160X240 的 分 辩 率 来 显示 ， 相 当 于 将 原 
图 缩小 50%， 通 过 代码 imView-.setScaleType(ImageView.ScaleTypeEFIT_ CENTER) 在 相 短 中 
居中 显示 。 

(4) 显示 主 界面 

完成 了 适配器 的 编写 后 ， 我 们 来 实现 图 像 显示 的 主 界面 逻辑 ， 代 码 如 下 : 

01 package com.L.gallerytest; 





03 import android.app.Activity; 

04 import android.os.Bundle; 

05 import android.view.View; 

06 import android.widget.AdapterView; 

07 import android.widget.Toast; 

08 import android.widget.AdapterView.OnItemClickListener; 
09 import android.widget.Gallery; 


10 

11 public class MygallerytestActivity extends Activity { 

2 /** Called when the activity is first created. */ 

3 @Override 

14 public void onCreate (Bundle savedInstanceState) { 

六 才 super.onCreate (savedInstanceState); 

16 setContentView(R.layout.main); 

17 

18 // 声 明 Gallery 并 设置 Adapter 

19 

20 Gallery gallery = (Gallery) findViewById(R.id.gallery1); 

本 gallery.setAdapter (new Adapter image (this)) 

22 gallery.setBackgroundResource (R.drawable.bg) : 

23 gallery.setOnItemClickListener (new OnItemClickListener() 1{ 

24 

25 Qoverride 

26 public void onItemClick (AdapterView<?> arg0, View argl, int 
arg2, 

Eh long arg3) { 

28 // TODO Auto-generated method stub 

29 Toast.makeText (getApplicationContext (), 

30 "第 " + (arg2 +1) + "号 图 片 "，, Toast.LENGTH SHORT) . 


show(); 
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3 

32 1D); 

33 } 

SS 

其 中 ，18 一 22 行 ， 定义 Gallery 并 绑 定 了 界面 显示 控件 ， 设 置 了 其 显示 的 图 像 适配器 
和 背景 图 片 ; 

23 一 31 行 ， 定 义 了 Gallery 中 加 入 了 捕获 单项 单 击 事件 的 函数 ， 用 以 捕获 单 击 每 一 张 
图 片 的 事件 。 在 单 击 函数 中 ， 我 们 实现 了 显示 提示 的 功能 。 

这 里 我 们 使 用 到 了 一 个 新 的 控件 ， 名 为 Toast， 在 Android 中 Toast 是 一 个 被 频繁 使 用 
的 “浮动 提示 器 ”， 我 们 这 里 只 是 简单 地 用 它 来 提示 一 些 文字 信息 ， 其 实 Toast 不 仅 可 以 
显示 文字 ， 还 能 显示 图 片 。 

Toast makeText 函数 的 第 一 个 参数 用 来 获得 当前 程序 的 上 下 文 环 境 Context， 第 二 个 参 
数 是 要 显示 的 文字 ， 第 三 个 参数 是 显示 的 时 间 长 短 ， 最 后 的 show 函数 是 显示 这 个 Toast。 

图 2.38 中 相 短 显示 了 3 张 图 片 ， 背 景 图 是 渐变 色 的 图 案 ， 我 们 可 以 左右 滑动 图 片 ， 并 
单 击 第 三 张 图 片 ， 可 以 得 到 结果 如 图 2.40 所 示 。 























2.4.4 四 宫 格 


在 Android 开发 中 ， 我 们 经 常 要 使 用 到 宫 格 。 例 如 ， 在 查看 Android 手机 所 有 程序 的 
列表 时 ， 就 是 用 宫 格 来 实现 的 ， 根 据 大 小 ， 有 十 二 宫 格 、 九 宫 格 、 十 六 宫 格 等 ， 比 较 常 用 
的 是 十 二 宫 格 。 宫 格 使 得 界面 看 起 来 简洁 、 整 齐 。 下 面 就 通过 一 个 简单 的 宫 格 来 学 习 宫 格 
的 写法 ， 这 里 的 例子 是 写 个 四 宫 格 ,举一反三 ， 九 宫 格 的 方法 类 似 。 

通过 之 前 的 ListView、Gallery 等 控件 的 使 用 ， 我 们 先 来 想 想 宫 格 需要 怎么 实现 。 单 个 
的 宫 格 肯定 需要 适配器 来 统一 配置 , 每 个 宫 格 内 按 实 际 情况 可 能 需要 个 ImageView 来 显 
示 每 项 的 图 片 和 一 个 TextView 来 显示 每 项 的 名 称 。 想 好 这 些 ， 我 们 来 着 手写 我 们 的 程序 ， 
在 本 例 中 我 们 不 仅 可 以 学 习 到 如 何 写 四 宫 格 的 界面 , 还 能 学 到 新 的 控件 AlertDialog.Builder 
的 使 用 。 本 例 中 实现 的 四 宫 格 ， 效 果 如 图 2.41 所 示 。 








避 赣 多 12:4m 








图 2.40 ” 单 击 图 片 触发 事件 图 2.41 四 宫 格 


对 于 这 样 一 个 四 宫 格 效果 ， 需 要 通过 如 下 几 步 来 实现 : 
(1) 宫 格 总 体 界面 布局 
首先 找 4 张 图 片 , 分 别 作为 四 宫 格 每 项 的 图 片 显示 , 然后 我 们 开始 重 写 main.xml 文件 ， 
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在 其 中 加 入 GridView 控件 ， 这 个 很 简单 ， 代 码 如 下 : 


<?xm] version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="wrap content" 
android:layout height="wrap content"> 
<GridView android:id="@+id/mygridview" android:numColumns="2" 
android:gravity="center horizontal" android:layout width= 
"wrap content" 
android:layout height="wrap content"> 
</GridView> 
</LinearLayout> 


其 中 ，android:numColumns="2" 用 来 设置 宫 格 的 列 数 ， 这 里 为 2 列 ， 同 理 若 是 写 九 宫 
格 三 行 三 列 的 那 种 形式 ， 则 需 设 置 成 3。 

(2) 宫 格 单个 布局 

进行 了 总 体 宫 格 行列 布局 后 ， 我 们 需要 针对 每 一 个 宫 格 进行 布局 。 我 们 在 layout 文件 
夹 下 ， 新 建 一 个 名 为 grid_item.xml 的 xml 文件 ， 用 来 编写 适配器 需要 用 到 的 控件 ， 适 配器 
在 之 前 已 经 学 习 到 很 多 ， 这 里 就 不 多 讲 。 每 一 宫 格 都 是 一 个 图 像 与 其 对 应 的 文字 说 明 ， 具 
体 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout android:id="@+id/RelativeLayout01" 
android:layout width="fill parent" android:layout height="fill 
Parent" 
xmlns:android="http://schemas.android.com/apk/res/android" android: 
layout gravity="center"> 
<ImageView android:id="@+id/image item" android:layout width="wrap_ 
content" 
android:layout height="wrap content" android:layout centerInParent= 
"true"> 
</ImageView> 
<TextView android:id="@+id/text item" android:layout below="@+id/ 
image item" 
android:layout height="wrap_ content" android:layout width="wrap_ 
content™" 
android:layout centerHorizontal="true"> 
</TextView> 
</RelativeLayout> 


(3) 数据 显示 

实现 了 界面 的 布局 之 后 ,我们 需要 实现 其 中 的 具体 显示 数据 以 及 逻辑 。 在 主 Java 文件 
中 实现 该 代码 ， 用 来 控制 GridView 和 适配器 Adapter， 其 代码 如 下 : 

01 public class Callinfakeup extends Activity { 


02 /** Called when the activity is first created. */ 

03 private GridView gridview; 

04 @Override 

05 public void onCreate (Bundle savedInstanceState) { 

06 super.onCreate (savedInstanceState); 

办 入 setContentView(R.layout .main); 

08 

09 // 使 用 List 来 生成 数据 ， 此 处 为 自己 填写 数据 ， 也 可 以 用 别 的 方法 获得 数据 

10 

加 List<Map<String, Object>> items = new ArrayList<Map<String, 


Object>>(); 
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for (int T= 0 < Ar Thy 和 
String xString=""; 
Map<String, Object> item = new HashMap<String, Object>(); 
item.put ("imageItem", R.drawable.navil+i); 
xString=getSstring(R.string.navil+i); 
item.put ("textItem", xString); 
items.add (item); 
SimpleAdapter adapter = new SimpleAdapter (this, items, R.layout. 
grid item, new 21 String[]{"imageItem", "textItem"}, new int 
[]{R.id.image item, R.id.text item}); 
gridview = (GridView)findViewById(R.id.mygridview); 
gridview.setAdapter (adapter); 


其 中 ，09 一 19 行 ， 实 现 了 需要 显示 的 数据 的 保存 ; 
20 一 23 行 ， 显示 数据 与 显示 界面 的 匹配 。 该 过 程 和 ListView 的 数据 适 配 类 似 , 不 再 袭 述 。 


(4) 单 击 事件 





通过 上 述 步骤 ， 我 们 实现 了 四 宫 格 的 显示 。 但 是 ， 除 了 富 格 显示 之 外 ， 最 重要 的 是 选 
择 功能 后 的 界面 跳 转 。 在 宫 格 中 需要 进行 单 击 事件 处 理 。 


01 
02 
03 


26 
之 下 
28 
p42 
30 
3 





gridview.setOonItemClickListener (new AdapterView.OnItemClickListener(){ 
@Override 
Public void onItemClick (AdapterView<?> arg0, View argl, int 
arg2, 
long arg3) { 
// 此 处 switch 是 选择 单 击 事件 ， 判 断 单 击 的 是 哪 一 项 


switch (arg2) { 
case 0: 
Intent intent = new Intent(); 
intent .setClass (Callinfakeup.this, CallinDisguise. 
class); 
Callinfakeup.this.startActivity (intent); 
// 跳 转 到 不 同 的 activity 
break; 
case 1 
Intent i = new Intent(); 
i.setClass (Callinfakeup.this, smsfakeup.class); 
startActivity (i); 
break; 
case 2: 


// AlertDialog .Builder 的 用 法 


new AlertDialog.Builder (Callinfakeup.this) 
.setTitle ("使 用 帮助 ") 
-SetMessage( 
"1L、 来 电 伪装 : \n\r 来 电 号 码 处 填 入 电话 号 码 , 时 间 处 
填 上 您 期 望 在 多 少 分 钟 之 后 来 电 . \n\r2、 短 信 伪 装 : 
\n\r 短信 号 码 填 入 手机 号 码 , 短信 内 容 处 填 上 将 要 接收 
到 的 短信 的 内 容 , 在 时 间 处 填 上 您 期 望 在 多 少 分 钟 之 后 接 
收 到 该 短信 .") 
.SetPositiveButton ("OK", 
new DialogInterface.OnClickListener() { 
Public void onClick (DialogInterface dialog, 
int whichButton) { 
} 
}) -show() ; 
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32 break; 

33 Case 3: 

34 new AlertDialog.Builder (Callinfakeup.this) 

5 -SetTitle ("关于 ") 

36 .SetMessage ("软件 版 本 : 1.1.0\n\r 开发 者 : xxx \n\r") 

37 .SetPositiveButton ("OK", 

38 new DialogInterface.OnClickListener() { 

39 public void onClick(DialogInterface 
dialog, 

40 int whichButton) { 

41 } 

42 ]}) .show () ; //show 方法 和 Toast 控件 类 似 

43 break; 

44 default: 

45 break; 

46 } 

47 } 

48 }); 

49 } 

50 } 


01 一 03 行 ， 添 加 了 宫 格 中 每 一 项 的 单 击 处 理事 件 。 需 要 
这 个 函数 的 参数 arg2 是 表示 单 击 的 次 序 。 在 宫 格 中 ， 每 项 的 序号 
次 从 0 开始 递增 ; 

07 行 ， 判 断 单 击 的 是 宫 格 中 的 哪 一 项 ; 

08 一 17 行 ， 进 行 功能 的 界面 跳 转 ; 

20 一 32 行 ， 实 现 了 一 个 可 操作 的 提示 警告 界面 AlertDialog。 

AlertDialog 与 之 前 我 们 使 用 的 提示 用 户 的 Toast 有 所 不 同 , 运行 ede tare 
其 中 , 方法 setTitle0 是 设置 当前 的 控件 标题 ; 方法 setMessage0 是 pb 的 主题 信息 ; 方 
法 setPossitiveButton() 是 设置 提示 框 的 左 按钮 RESULT_OK, 一 般 是 OK、“ 确 定 ” 之 关 的 ， 
相应 的 也 有 setNegativeButton，setNegativeButton 是 用 来 设置 “ hy 、Cancel 等 按钮 。 最 
后 使 用 show0 函 数 来 显示 该 提示 框 AlertDialog.Builder。 

这 样 ， 实 现 了 整个 四 宫 格 效 果 。 运 行 该 代码 ， 单 击 四 宫 格 的 第 一 项 和 第 三 项 ， 可 以 看 
到 如 图 2.42 和 图 2.43 所 示 结 果 ， 其 中 第 三 项 是 AlertDialog.Builder 显示 的 提示 。 





龟 的 是 函数 onItemClick0， 
是 从 上 往 下 、 从 左 至 右 依 





[© 使 用 帮助 


1、 来 电 伪装 ; 
来 电 号 码 处 填 入 电话 号 码 ,时 间 
pm 
六 短信 伪装: 
| 
处 填 上 将 要 接收 到 的 短信 的 内 
富里 公 吉 上 入 关 电 在 2 
钟 之 后 接收 到 该 短信 . 





图 2.42 第 一 个 宫 跳 转 的 界面 图 2.43 第 三 个 宫 格 弹出 的 提示 
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2.5 Android 中 的 常用 特效 


Android 中 不 仅 提供 多 种 控件 来 实现 程序 功能 ， 还 能 有 多 种 的 特效 ， 这 节 我 们 主要 学 
习 Android 中 经 常 使 用 的 一 些 特效 。 





2.5.1 滚动 文字 


我 们 经 常 可 以 在 一 些 应 用 中 , 看 到 一 些 文字 信息 是 一 直 在 滚动 , 这 种 效果 俗称 飞行 字 ， 
或 者 跑马 灯 效果 。 下 面 我 们 通过 一 段 简单 的 代码 来 学 习 如 何 做 出 滚动 字 效 果 。 
比如 我 们 将 TextView 控件 中 的 文字 做 成 跑马 灯 效 果 ， 代 码 如 下 : 


<TextView android:layout width="100px" 
android:layout height="wrap content" 
android:textColor="@android:color/white" 
android:ellipsize="marquee" 
android:focusable="true" 
android:marqueeRepeatLimit="marquee forever" 
android:focusableInTouchMode="true" 
android:scrollHorizontally="true" 
android:text=" 飞 行文 字 跑 马 灯 滚 动 文字 效果 " 
/> 











代码 很 简单 ， 我 们 挑 几 句 来 看 看 ，android:ellipsize="marquee" 这 名 代码 是 创建 滚动 效 
果 ，android:marqueeRepeatLimit="marquee_forever" 是 设置 深 动 时 间 ， 此 处 设置 的 是 一 直 演 
动 ，android:scrollHorizontally="true" 是 设置 水 平 滚 动 ， 其 他 的 代码 比较 好 懂 。 我 们 新 建 
个 工程 ， 并 运行 这 个 程序 ， 可 以 看 到 如 图 2.44 和 图 2.45 的 效果 。 


Mytest 


飞 跑 马 灯 滚动 文字 交 





图 2.44 滚动 文字 效果 图 2.45 文字 从 左 往 右 滚动 
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2.5.2 ”震动 效果 


在 一 些 游戏 中 ， 我 们 经 常 看 到 游戏 结束 时 ， 假 如 失败 的 话 ， 会 有 感觉 到 震动 ， 那 么 在 
Android 中 震动 效果 是 如 何 实现 的 呢 ? 其 实在 Android 已 经 提供 了 震动 的 接口 ，Vibrator 用 
来 统一 管理 震动 效果 ， 只 需要 调用 代码 Vibrator vibrator=(Vibrator) getSystemService 
(VIBRATOR_SERVICE) 就 能 使 用 震动 效果 了 ， 具 体 还 是 看 以 下 代码 : 


package com.L.Mytest; 





import android.app.Activity; 
import android.os.Bundle; 

import android.os.Vibrator; 
import android.view.MotionEvent; 


public class MytestActivity extends Activity { 
/** Called when the activity is first created. */ 
public Vibrator mVibrator; 


Q@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout .main); 


// 重 写 接 口 
@Override 
public void onStop () { 
if (mVibrator != null) { 
mVibrator.cancel (); 
} 
Super .onStop () 7 


@Override 
Public boolean onTouchEvent (MotionEvent event) { 
if (event.getAction() == MotionEvent.ACTION DOWN) { 


mVibrator = (Vibrator) getSystemService (VIBRATOR SERVICE); 
long[] pattern = { 400, 50, 400, 50 }; 
mVibrator.vibrate (pattern, 2); 

5 


return super.onTouchEvent (event); 


在 以 上 代码 中 ， 我 们 重 写 了 Activity 中 的 onStop 这 个 接口 ， 代 码 的 意思 是 如 果 程 序 售 
止 时 ，Vibrator 存在 的 话 ， 则 停止 它 。 而 在 onTouchEvent 中 ， 我 们 重 写 了 事件 ， 意 思 是 如 
果 屏 幕 上 有 单 击 事件 的 话 , 就 会 开始 震动 。 vibrate 函数 的 第 一 个 参数 是 一 个 长 整 型 的 数组 ， 
用 来 指定 震动 的 强 弱 ， 而 第 二 个 参数 是 指 从 数组 中 对 应 下 标的 元 素 开始 重复 震动 ， 若 是 -1 
就 不 震动 。 

以 上 代码 在 模拟 器 中 无 法 测试 ， 需 要 用 真 机 进行 调试 。 
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2.5.3 ”镜像 特效 


之 前 我 们 学 习 Gallery 时 ， 可 以 看 到 Gallery 中 保存 了 一 系列 图 片 ， 图 片 在 容器 中 可 以 


是 横向 排列 或 者 是 垂直 排列 ， 而 在 现在 一 些 手机 应 用 中 ， 
经 常 可 以 看 到 一 些 非常 立体 的 图 片 在 类 似 Gallery 的 容器 
中 显示 ， 这 就 需要 用 到 我 们 的 镜像 特效 ， 来 使 得 图 片 显 得 
更 加 立体 。 

镜像 特效 ， 顾 名 思 义 ， 在 图 片 下 方 加 上 本 身 图 片 的 倒 
影 ， 同 时 生成 的 倒影 经 过 模糊 和 适当 的 压缩 等 处 理 ， 使 得 
原来 的 图 片 像 是 放 在 一 面 镜子 上 ， 从 而 使 本 身 看 起 来 更 加 
立体 ， 这 就 是 镜像 特效 。 为 了 完成 镜像 特效 ， 我 们 结合 2 
前 的 学 习 ， 会 想到 可 能 需要 重 写 Gallery 类 、ImageView 
类 和 适配器 Adapter 类 。 首先, 找 5 张 320X480 的 图 片 放 
在 Drawable-hdpi 文件 夹 中 ， 以 供 显示 。 实 现 的 效果 如 图 
2.46 所 示 。 

要 实现 这 样 的 镜像 特效 ， 需 要 进行 如 下 几 步 : 

(1) 相 簿 显示 





在 相 短 显示 中 ,我 们 实现 的 图 像 不 再 是 同一 水 平 线 上 图 2.46 镜像 特效 


的 显示 ， 对 于 两 侧 的 图 片 进行 了 一 定 角度 的 旋转 以 及 远 小 
近 大 的 处 理 。 具 体 实现 如 下 : 
public class MyMirrorGallery extends Gallery { 


private Camera mCamera = new Camera(); 


private int mMaxRotationAngle = 60; // 绕 y 轴 角 度 


private int mMaxZoom = -380; // 图 片 在 z 轴 平 移 的 距离 


private int mCoveflowCenter; 
private boolean mAlphaMode = true; 
private boolean mCircleMode = false; 


public int getMaxRotationAngle() { 
return mMaxRotationAngle; 


public void setMaxRotationAngle (int maxRotationAngle) 
mMaxRotationAngle = maxRotationAngle; 


public boolean getCircleMode() { 
return mCircleMode; 


public void setCircleMode (boolean isCircle) { 
mCircleMode = isCircle; 


public boolean getAlphaMode() { 
return mAlphaMode; 





public void setAlphaMode (boolean isAlpha) { 
mAlphaMode = isAlpha; 
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public int getMaxZoom() { 
return mMaxZoom; 


public void setMaxZoom(int maxZoom) { 
mMaxZoom = maxZoom; 


private int getCenterOfCoverflow() { 
return (getWidth() - getPaddingLeft() - getPaddingRight()) / 2 
+ getPaddingLeft (); 





// 得 到 子 对 象 的 中 线 

Private static int getCenterOfView(View view) { 
return view.getLeft() + view.getWidth() / 2; 

;3 


protected boolean getChildStaticTransformation (View child, Transformation 
1 | 
final int childCenter = getCenterOfView (child); 
final int childwidth = child.getWidth(); 
int rotationAngle = 0; 
t.clear (); 
t.setTransformationType (Transformation.TYPE MATRIX); 
if (childCenter == mCoveflowCenter) { 
transformImageBitmap ( (ImageView) child, t, 0); 
} else { 
rotationAngle = (int) (((float) (mCoveflowCenter - childCenter) 
/ childwidth) * mMaxRotationAngle); 
if (Math.abs (rotationAngle) > mMaxRotationAngle) { 
rotationAngle = (rotationAngle < 0) ? -mMaxRotationAngle 
: mMaxRotationAngle; 
} 
transformImageBitmap ( (ImageView) child, t, rotationAngle); 
| 
return true; 


} 


protected void onSizeChanged(int w, int h, int oldw, int oldh) { 
mCoveflowCenter = getCenterOfCoverflow(); 
super.onSizeChanged(w, h, oldw, oldh); 

} 


private void transformImageBitmap (ImageView child, Transformation t, 
int rotationAngle) { 
mCamera.save(); 
final Matrix imageMatrix = t.getMatrix(); 
final int imageHeight = child.getLayoutParams() .height; 
final int imageWidth = child.getLayoutParams () .width; 
final int rotation = Math.abs (rotationAngle); 
mCamera.translate(0.0f, 0.0f, 100.0f); 


// 远 小 近 大 的 视觉 效果 


if (rotation <= mMaxRotationAngle) { 
float zoomAmount = (float) (mMaxZoom + (rotation * 1.5)); 
mCamera.translate(0.0f, 0.0f, zoomAmount); 
if (mCircleMode) { 
if (rotation < 40) 
mCamera.translate (0.0f, 155, 0.0f); 
else 
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mCamera.translate (0.0f, (255 - rotation * 2.5f), 0.0f); 
} 
if (mAlphaMode) { 
((ImageView) (child)) .setAlpha((int) (255 - rotation * 
2.5)); 
} 
} 
mCamera .rotateY (rotationAngle); 
mCamera.getMatrix(imageMatrix); 
imageMatrix.preTranslate(- (imageWidth / 2), -(imageHeight / 2)); 
imageMatrix.postTranslate( (imageWidth / 2), (imageHeight / 2)); 
mCamera.restore(); 


} 


其 中 ，Camera 是 声明 的 android.graphics 包 中 的 Camera 类 ,用 来 做 图 像 3D 效果 处 理 ， 
比如 z 轴 方 向 上 的 平移 、 绕 y 轴 的 旋转 等 。 构 造 函 数 有 3 个 ， 以 上 省 略 ， 都 比较 简单 ， 详 
细 的 代码 可 以 在 光盘 源码 中 看 到 ， 经 常 使 用 的 是 用 Context 来 初始 化 我 们 的 Gallery。 

mMaxRotationAngle 这 个 变量 用 来 记录 一 个 旋转 的 角度 , 我 们 都 知道 Gallery 中 一 般 很 
少 只 显示 一 个 图 片 ， 那 么 除了 正中 央 的 图 片 外 ， 还 有 两 侧 的 图 片 ， 为 了 能 让 中 央 图 片 更 加 
立体 化 ， 我 们 让 两 侧 图 片 适当 向 内 侧 倾斜 一 个 角度 ， 即 以 屏幕 垂直 线 为 y 轴 的 话 ， 这 个 角 
度 是 绕 y 轴 旋 转 的 角度 。 

mMaxZoom 这 个 变量 是 让 两 侧 图 片 的 高 度 向 内 逐步 缩小 , 视觉 上 给 人 一 种 远 小 近 大 的 


transformImageBitmap 函数 完成 的 工作 主要 是 让 两 侧 的 图 片 向 内 旋转 ， 左 侧 的 图 片 和 
右 侧 图 片 角度 一 样 只 是 正 负 不 同 。 

(2) 镜像 效果 

我 们 已 经 实现 了 基本 的 正 向 显示 ， 并 且 在 正 向 显示 中 具有 了 立体 效果 。 接 下 来 ， 我 们 
实现 其 镜面 的 效果 。 有 具体 的 显示 实现 代码 如 下 : 


public class MyImage extends ImageView { 
private boolean mReflectionMode = true; 


public void setReflectionMode (boolean isRef) { 
mReflectionMode = isRef; 
} 


public boolean getReflectionMode() { 
return mReflectionMode; 
} 
@Override 
public void setImageResource (int resId) { 
Bitmap originalImage = BitmapFactory.decodeResource 
(getResources () ， 
resId); 
DoReflection (originalIlImage); 


} 


private void DoReflection (Bitmap originalImage) { 
final int reflectionGap = 4; // 原 始 图 片 和 反射 图 片 中 间 的 间距 
int width = originalImage .getWidth() > 
int height = originalImage -getHeight (); 
// 反 转 原始 图 片 
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Matrix matrix = new Matrix(); 

matrix.preScale (1, -1); 

Bitmap reflectionImage = Bitmap.createBitmap (originalImage, 0, 0, 
width, (height/4)*3, matrix, false); 


// 创 建 一 个 新 的 bitmap， 高 度 为 原来 的 两 倍 ， 其 中 填充 原 图 和 倒影 

Bitmap bitmapWithReflection = Bitmap.createBitmap (width, 
(height + height), Config.ARGB 8888); 

Canvas canvasRef = new Canvas (bitmapWithReflection); 


// 先 画 原始 的 图 片 


canvasRef .drawBitmap (originalImage, 0, 0, null); 


// 画 间距 

Paint deafaultPaint = new Paint(); 

canvasRef.drawRect (0, height, width, height + reflectionGap, 
deafaultPaint); 


// 画 被 反 转 以 后 的 图 片 

canvasRef .drawBitmap (reflectionImage, 0, height + reflectionGap, 

null); 

Paint paint = new Paint(); 

LinearGradient shader = new LinearGradient(0, 
originalImage.getHeight(), 0, bitmapWithReflection. 
getHeight () 

+ reflectionGap, Ox80ffffff, Ox0O0ffffff, TileMode. 
CLAMP); 

Paint.setShader (shader); 

paint.setXfermode (new PorterDuffXfermode (Mode.DST IN)); 

canvasRef .drawRect (0, height, width, bitmapWithReflection. 

getHeight () 
+ reflectionGap, paint); 
this.setImageBitmap (bitmapWithReflection); 


} 


其 中 , 在 DoReflection 函数 中 ，reflectionImage 用 来 创建 一 个 新 图 片 ， 就 是 倒影 。 为 了 
更 加 逼真 ， 高 度 设置 成 了 原来 图 片 高 度 的 3/4， 这 是 为 了 模仿 水 和 空气 不 同 的 折射 率 ， 造 
成 人 视觉 上 对 水 中 物体 感觉 比 空气 中 原始 物体 更 短 。 

bitmapWithReflection 用 来 画 出 原始 图 片 和 倒影 。shader 是 线性 蒙 化 方法 ， 为 倒影 加 上 
阴影 ， 使 得 倒影 更 加 真实 。 

(3) 显示 图 片 

我 们 再 来 看 Adapter 适配器 该 如 何 写 ， 适 配器 我 们 之 前 学 习 到 很 多 了 ， 此 处 我 们 只 学 
习 其 中 getView 函数 的 写法 ， 详 细 代 码 见 光盘 源码 ， 代 码 如 下 : 


public View getView(int position, View convertView, ViewGroup parent) { 
MyImage i = new MyImage (mContext); 





i.setImageResource (Imgid[position]); 
i.setLayoutParams (new MyMirrorGallery.LayoutParams (160, 240)); 


// 设 置 图 像 大 小 
i.setScaleType (ImageView.ScaleType.CENTER INSIDE); 


// 设 置 图 片 显 示 的 模式 
BitmapDrawable drawable = (BitmapDrawable) i.getDrawable(); 
drawable. setAntiAlias (true); // 设 置 抗 锯齿 


。68 。 


第 2 章 ” Android 界面 设计 








return i; 


} 


以 上 代码 中 ，setLayoutParams 函数 使 用 了 我 们 新 的 Gallery 类 , 并 且 将 图 片 设置 成 160 
X240 大 小 ， 我 们 找 的 图 片 是 320X480 大 小 的 ， 也 就 是 说 图 片 是 原 图 的 一 半 。drawable. 
setAntiAlias(true) 用 于 设置 抗 锯 具 。 

(4) 自 定义 控件 布局 

由 于 此 处 需要 用 到 新 的 自 定义 的 MyMirrorGallery 控件 , 和 以 往 有 些 不 同 , 在 main.xml 
布局 文件 ， 具 体 代码 实现 如 下 : 

<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:layout width="fill parent" 
android:layout height="fill parent" 


android:orientation="vertical" 
android:gravity="center"> 





<com.L.Mytest.MyMirrorGallery // 自 己 定义 的 控件 
xmlns:android="http://schemas.android.com/apk/res/android" 
// 命 名 空间 


android:id="@+id/Mygallery" 
android:layout width="fill parent" 
android:layout height="fill parent" /> 


</LinearLayout> 


其 中 ， 整 体 是 一 个 LinearLayout 线性 布局 ， 显 示 了 一 个 自 定义 的 控件 。 对 于 自 定义 控 
件 使 用 该 控件 定义 类 的 全 路 径 来 标识 , 本 例 中 的 使 用 com.L.MytestMyMirrorGallery 来 指定 
使 用 我 们 程序 所 在 包 中 的 新 自 定义 控件 。 

运行 该 实例 , 实现 的 效果 如 图 2.46 所 示 。 当 然 对 于 这 样 的 镜像 特效 , 还 有 可 改进 之 处 ， 
可 以 使 用 复杂 的 算法 来 将 图 片 倒影 进一步 虚 化 ， 将 边 角 模 糊 ， 使 得 倒影 更 真实 ， 有 兴趣 的 
读者 可 以 自己 进行 尝试 。 


2.6 Android 的 主题 和 风格 


在 Web 开发 中 ， 通 常 是 HTML 负责 内 容 部 分 ，CSS 负责 具体 表现 ， 而 在 Android 的 
开发 中 ， 我 们 也 可 以 类 似 地 使 用 Theme、Style+UI 组件 的 方式 ， 实 现 内 容 和 形式 的 分 离 ， 
做 到 界面 的 自 定义 。 

风格 Style 是 一 个 包含 一 种 或 多 种 格式 化 属性 的 集合 ， 你 可 以 把 它 应 用 到 一 系列 的 UI 
组 件 上 ， 这 几 种 组 件 风格 类 似 。 

主题 Theme 也 是 一 个 包含 一 种 或 多 种 格式 化 属性 的 集合 ， 和 风格 的 不 同 在 于 ， 主题 可 
以 应 用 在 整个 应 用 程序 (Application) 中 或 者 某 个 窗口 (Activity) 中。 

定义 一 个 Style 或 者 Theme 的 方法 是 一 样 的 。 在 res/values/ 目 录 下 建立 style.xml 或 者 
theme.xml 文件 ， 在 官方 文档 中 有 如 下 的 简单 的 代码 : 


<?xml] version="1.0" encoding="utf-8"?> 
<resources> 
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<style name="CodeFont" parent="@android:style/TextAppearance.Medium"> 


// 定 义 风格 
<item name="android:layout width">fi11 parent</item> 
<item name="android:layout height">wrap content</item> 


<item name="android:textColor">#00ff00</item> // 定 义 颜色 
<item name="android:typeface">monospace</item> 
</style> 
</resources> 
上 面 代码 中 定义 了 宽度 、 高 度 、 颜 色 等 风格 属性 。 下 面 我 们 通过 一 个 例子 来 学 习 如 何 
使 用 风格 和 主题 。 
(1) 风格 图 像 资源 定义 
首先 ， 我 们 寻找 儿 张 能 作为 按钮 背景 色 的 9-patch 图 片 ，9-patch 图 片 能 在 不 失真 的 情 
况 下 进行 缩放 。 我 们 找 了 如 图 2.47 所 示 的 图 片 资源 。 








图 2.47 9-patch 图 片 


然后 ， 我 们 将 图 片 放 到 Drawable 文件 夹 下 ， 然 后 在 Drawable 文件 夹 中 新 建 一 个 
mystyle.xml 文件 用 来 确定 按钮 风格 ， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:drawable="@drawable/btn red" android:state enabled="false"> 
<item android: drawable="@drawable/btn | orange" 
android:state enabled="true" android:state pressed="true"> 
<item android:drawable="@drawable/btn orange" 
android:state enabled="true" android:state focused="true"> 
<item android:drawable="@drawable/btn black" 
android:state enabled="true"> 
</item> 
</item> 
</item> 
</item> 
</selector> 


其 中 ， 使 用 了 背景 选择 器 selector， 让 按钮 在 不 同 状态 下 呈现 不 同 的 颜色 。 
(2) 风格 值 定义 
在 res/values 中 需要 定义 style 内 容 ， 代 码 如 下 : 


<?xml] version="1.0" encoding="utf-8"?> 
<resources> 
<style name="BasicButtonStyle" parent="@android:style/Widget.Button"> 
// 定 义 按钮 风格 
<item name="android:gravity">center verticallcenter horizontal 
</item> 
<item name="android:textColor">#ffffffff</item> 
<item name="android:shadowColor">#ff000000</item> 
<item name="android:shadowDx">0</item> 
<item name="android:shadowDy">-1</item> 
<item name="android:shadowRadius">0.2</item> 
<item name="android:textSize">16dip</item> 
<item name="android:textStyle">bold</item> 
<item name="android:background">@drawable/mystyle</item> 
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<item name="android:focusable">true</item> 
<item name="android:clickable">true</item> 

</style> 

<style name="BigTextStyle"> // 定 义 字 体 风 格 
<item name="android:layout margin">5dp</item> 
<item name="android:textColor">#ff9900</item> 
<item name="android:textSize">25sp</item> 

</style> 

<style name="BasicButtonStyle.BigTextStyle"> 
<item name="android:textSize">25sp</item> 

</style> 


</resources> 


以 上 代码 细致 定义 了 按钮 中 的 颜色 、 字 体 、 布 局 等 属性 ， 有 3 种 不 同 的 风格 。 
完成 了 不 同 风格 的 具体 定义 后 ， 我 们 需要 在 res/values 目录 中 定义 Theme 文件 ， 代 码 
如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<resources> 

<style name="BasicButtonTheme"> 
<item name="android:buttonSstyle">@style/BasicButtonSstyle</item> 
<item name="android:windowBackground">@android:color/transparent 
</item> 
<item name="android:windowIsTranslucent">true</item> 

</style> 
</resources> 


以 上 代码 定义 了 整个 程序 的 主题 ， 背 景色 是 透明 的 ，Button 的 风格 采用 了 刚 定义 好 的 
风格 ， 在 刚 写 好 的 Style-xml 中 。 

(3) 布局 XML 文件 实现 

完成 了 风格 的 具体 定义 后 ， 在 布局 文件 中 我 们 就 可 以 使 用 这 些 定义 了 风格 的 按钮 。 其 
代码 实现 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout height="fill parent" android:layout width="fill parent" 
android:orientation="vertical"> 
<TextView android:layout height="wrap_content" 
android:layout width="fill parent" android:text="Paramore"/> 
<Button android:layout height="wrap content" 
android:layout width="wrap_content" android:text="Hello cold 
world" 
android:id="@+id/Button01"> 
</Button> 
<Button android:layout height="wrap Content" 
android:layout width="wrap_ content" android:text="Playing 
god" 
android:id="@+id/Button02"> 
</Button> 
<Button android:layout height="wrap content" 
android:layout width="wrap content" android:text="When it 
rains™ 
android:id="@+id/Button03"> 
</Button> 
<Button android:layout height="wrap content" 
android:layout width="wrap content" android:text="Misguided 
ghosts" 
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android:id="@+id/Button04"> 


</Button> 


<Button android:layout height="wrap Content" 
android:layout width="wrap content" android:text="Where the 


lines overlap" 


android:id="@+id/Button05"> 


</Button> 


<Button android:layout height="wrap Content" 
android:layout width="wrap content" android:text="Star" 


android:id="@+id/Button06"> 


</Button> 
</LinearLayout> 


(4) 风格 的 使 用 


最 后 我 们 在 AndroidManifest.xml 中 给 整个 应 用 程序 设置 主题 , 我 们 在 Application 中 设 


置 ， 如 图 2.48 所 示 。 


"Application Attribates 四 
nines the attributes specifie to the sppliestion 
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[style/BasichuttonThene 





] [Brorse | Enabled 








Debageable 






Ieon [oarewable/icon 


Description 
Pernission 
Process 


Task sffinity 


en task roperentine | 


Has code 
Persistent 








Ve safe mode 








Menage space activity 
Allow clenr user dats 


Test only 





Backup gent 














Allow becimp 





Ki sfter restore 


Bestore needs applice 


| Bestore any version 


可 wifest (A]Application [(F] Permissions [IT]Instromentation 习 Androi Munifest, xal| 


图 2.48 


设置 主题 


也 可 以 直接 在 AndroidManifest.xml 文件 里 的 Application 节点 处 加 上 以 下 代码 : 
android:theme="@style/BasicButtonTheme"， 效 果 和 在 上 图 的 可 视 化 界面 上 操作 是 一 样 的 。 
运行 程序 , 可 以 看 到 如 图 2.49 所 示 的 , 大 小 不 一 但 风格 一 样 的 按钮 , 以 及 整个 程序 的 主题 。 

对 于 该 风格 的 实现 ， 我 们 添加 了 多 个 资源 文件 ， 整 个 工程 目录 如 图 2.50 所 示 。 


岛 硬 遇 11:33 和 mm 


Mystyletest 





图 2.49 主题 和 风格 
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图 2.50 工程 结构 
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本 章 首先 介绍 了 Android 界面 开发 中 的 一 些 原则 ， 然 后 介绍 了 界面 工具 DroidDraw 的 
使 用 ， 接 着 从 最 简单 的 布局 和 控件 讲 起 ， 而 后 综合 一 些 实例 ， 展 现 了 控件 是 如 何 组 合 在 一 起 
工作 的 。 最 后 讲述 了 一 些 常用 特效 和 在 Android 中 如 何 使 用 自 定义 控件 ， 以 及 风格 和 主题 的 使 
用 , 基本 上 禾 盖 了 界面 开发 中 常用 的 所 有 细节 。 基 本 布局 和 控件 是 实现 应 用 程序 的 基础 ， 是 必 
须 熟 练 掌握 的 技能 ， 而 自 定义 控件 和 一 些 特效 相对 较 难 ， 在 后 面 的 实际 应 用 中 会 深入 介绍 。 

在 后 面 的 章节 中 ， 我 们 依然 会 使 用 到 这 些 界面 设计 ， 在 掌握 了 基本 设计 的 基础 上 ， 结 
合 其 他 知识 来 灵活 地 使 用 这 些 界面 布局 与 控件 。 











2.8 习 题 


【习题 1】 掌 握 五 大 基本 布局 方式 和 另 两 种 常用 布局 方式 及 各 布局 的 显示 效果 。 
【习题 2】 使 用 线性 布局 (LinearLayout) 实现 2.4.1 的 登录 界面 。 


全 提示 : 线性 布局 不 能 和 相对 布局 一 样 直 接 指定 控件 的 相对 位 置 ， 可 以 在 纵向 线性 布局 中 
添加 一 个 横向 线性 布局 来 实现 左右 排列 的 效果 。 


关键 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" > 
<LinearLayout 
android:layout width="fill Parent" 
android:layout height="fill parent" 
android:orientation="horizontal> 
<Button 
android:id="e@+id/button1" 
android:layout width="wrap_content" 
android:layout height="wrap_ content" 
android:layout weight="1" 
android:text=" 登 录 " /> 
<Button 
android:id="@+id/button2" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout weight="1" 
android:text=" 返 回 " /> 
</LinearLayout> 
</LinearLayout> 


【习题 3】 参照 2.4.1 登录 界面 的 内 容 ， 实 现 拘 秒表 的 功能 
全 提示 : 拘 秒表 的 功能 即 是 判断 两 次 单 击 同一 按钮 的 时 间 差 。 通过 实现 按钮 的 单 击 事件 来 
完成 。 关 键 代码 如 下 
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boolean first=true;// 未 开始 计时 为 true 
long start=0; 
long end=0; 
btn.setOnClickListener (new OnClickListener() { 
@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
宇和 (SE) 二 
start=System.currentTimeMillis(); 
first=false; 
jelse { 
end=System.currentTimeMillis(); 
first=true; 


【习题 4】 参照 2.4.2 体重 计算 器 的 内 容 ， 实 现 心理 测试 的 界面 。 


全 提示 : 心理 测试 类 型 的 应 用 ， 都 是 通过 单 选 问 题 的 答案 来 达到 测试 的 目的 。 使 用 单 选 控 
件 RadioGroup 来 实现 。 关 键 代码 如 下 : 


<?xml] version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/widget0" 
android:orientation="vertical" 
android:layout widt fill parent" 
android:layout height="fill parent"> 

<TextView 
android:id="@+id/showtext" 
androi extSize="25sp" 
android:layout widt 
android:layout heigh 
android:text=" 心 理 测试 " 
/> 

<RadioGroup 
android:id="@+id/radiogroup" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:orientation="vertical" 









rap_content" 
wrap_content™ 








2 
<RadioButton 
android:id="@+id/a" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="A"> 
</RadioButton> 
<RadioButton 
android:id="@+id/b" 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:text="B"> 
</RadioButton> 
</RadioGroup> 
</LinearLayout> 


【习题 5】 参照 2.4.4 四 宫 格 的 内 容 ， 实 现 九宫 格 的 效果 。 
全 提示 : 九宫 格 和 四 宫 格 在 实现 上 没有 本 质 的 区 别 ， 可 以 仔细 参考 四 宫 格 的 实现 步骤 。 
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Android 应 用 程序 使 用 Java 语言 编写 ， 在 支持 标准 Java 语言 的 同时 ， 也 根据 自身 结构 
设计 了 特有 组 件 和 机 制 .Android 中 有 4 大 组 件 , 分 别 是 Activity、 Service、 BroadcastReceiver 
和 Content Provider， 而 在 组 件 和 程序 之 间 进 行 消息 传递 则 使 用 Intent。 同 时 ， 针 对 线程 之 
间 的 信息 传递 也 提出 了 自己 特有 的 通信 机 制 。 本 章 主要 围绕 Android 应 用 程序 的 Activity、 
Service 和 BroadcastReceiver 3 个 组 件 和 线程 间 的 通信 来 进行 实例 讲解 。 





3.1 ”Activity 一 一 活动 


Android 应 用 程序 由 四 大 组 件 构 成 最 基本 的 框架 。 其 中 ，Activity 是 最 重要 也 是 使 用 频 
率 最 高 的 组 件 。 一 个 Activity 通常 是 一 个 单独 的 全 屏 显示 界面 ， 在 其 中 有 若干 视图 控件 以 
及 对 应 的 事件 处 理 。 大 部 分 应 用 程序 都 包含 了 多 个 Activity， 当 多 个 Activity 相互 跳 转 切换 
时 ， 就 形成 了 一 个 Activity 栈 ， 以 及 Activity 之 间 的 数据 交换 。 在 本 节 中 ， 我 们 将 通过 实 
例 来 对 Activity 的 创建 、 生 命 周期 以 及 相互 跳 转 切 换 等 进行 讲解 。 


3.1.1 横竖 屏 切 换 


由 于 Android 设备 一 般 都 带 有 重力 感应 系统 ， 当 我 们 改变 设备 的 摆 放 位 置 时 ， 系 统 会 
根据 当前 设备 的 位 置 来 实现 Activity 的 横 紧 屏 的 转换 。 但 是 ， 在 切换 之 后 ， 我 们 已 经 输入 
的 数据 都 会 消失 , 在 这 个 切换 过 程 中 , Activity 到 底 做 了 哪些 操作 ? 下 面 , 我 们 通过 Activity 
的 生命 周期 来 了 解 这 个 过 程 。 


1. Activity 生 命 周 期 


在 Android 系统 中 ，Activity 在 Activity 栈 中 被 管理 ， 当 前 活动 的 Activity 处 于 栈 顶 ， 
其 他 的 Activity 被 压 入 栈 中 处 于 非 活动 的 状态 。 所 以 , Activity 有 4 种 基本 的 状态 , 分 别 是 : 

口 活动 (Running) : 此 时 Activity 位 于 屏幕 的 最 前 端 ， 为 可 见 状态 并 且 可 与 用 户 交互 。 

口 暂停 (Paused) : 此 时 Activity 被 男 一 个 透明 的 或 者 非 全 屏 的 Activity 覆盖 ， 虽 然 

可 见 但 是 不 可 与 用 户 交 互 。 

口 停止 (Stop) : 此 时 Activity 被 男 一 个 Activity 覆盖 ， 界 面 不 可 见 。 

口 销毁 (Kiled) : 此 时 Activity 被 系统 结束 或 者 被 进程 结束 。 

(1) 状态 改变 

系统 通过 调用 Activity 中 的 方法 来 改变 当前 Activity 的 状态 ， 这 些 方法 一 共有 7 个 ， 
分 别 是 : 
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public class Activity extends ApplicationContext 


// 创 建 时 调用 


{ 


protected void onCreate (Bundle savedInstanceState); 


// 启 动 时 调用 

protected void onStart (); 

// 重 新 启动 时 调用 

protected void onRestart (); 

// 恢 复 时 调用 

protected void onResume (); 

// 暂 停 时 调用 

protected void onPause () 

// 停 止 时 调用 

protected void onStop () 7 

// 销 毁 时 调用 

protected void onDestroy(); 
} 


我 们 在 上 面 每 一 个 调用 函数 中 , 打印 出 此 时 的 状态 , 用 于 观察 在 横竖 屏 切换 时 Activity 


的 状态 变化 。 例 如 ，onCreate0 实 现 如 下 : 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout .main); 
Log.i(TAG, "this is onCreate"); 

| 


(2) 结果 分 析 


实现 了 这 样 的 代码 后 ， 使 用 模拟 器 运行 ， 此 时 默认 是 竖 屏 。 使 用 Ctrl+F11 组 合 键 来 将 
屏幕 方向 进行 切换 。 我 们 在 日 志 信息 中 ， 查 看 结果 如 图 3.1 所 示 。 


FI Application Tag 








I ET 


图 3.1 生命 周期 


Text 
this is onCreate 
this is onstart 
this ia onResune 
this is onpause 
this is onstop 
this is onDestroy 
this is onCreate 
this is onstart 









其 中 ， 横 线 以 上 的 部 分 是 Activity 在 切换 之 前 的 打印 结果 ， 可 以 看 出 Activity 通过 创 
建 (onCreate) 、 启 动 (onStart) 、 恢 复 (onResume) 之 后 才 进 入 活动 状态 (Running) 。 
这 个 时 候 , 可 以 对 其 进行 操作 。 在 切换 屏幕 方向 时 , 该 Activity 分 别 经 过 了 暂停 (onPause) 、 





停止 (onStop) 、 销 毁 (onDestroy) 后 ， 又 重新 创建 了 一 个 新 


的 Activity， 整 个 过 程 如 图 


3.2 所 示 。 这 样 也 很 好 理解 ， 当 横竖 屏 切 换 时 ， 之 前 输入 的 数据 由 于 没有 保存 ， 再 次 创建 


Activity 时 数据 丢失 。 
2. 实现 横竖 屏 切 换 
在 上 面 的 横竖 屏 切 换 时 ， 当 前 的 Activity 会 被 销毁 ， 然 后 对 





新 创建 一 个 新 的 Activity， 


这 样 会 导致 输入 的 数据 丢失 ， 为 了 避免 这 样 的 情况 ， 下 面 我 们 实现 横竖 屏 切换 时 ， 不 销毁 


当前 Activity。 


。76 。 


第 3 章 ”Android 应 用 程序 特性 








| 
User navigates 
back to the 
actvily ‘onStart() - onRestart() 


i 记 二 aa 
The activity 
comes IO the 























foreground 


The activity 
comes to the 
foreground 


Another activity comes 
in front of the activity 
















Other applications 
need memory 


The activity is no longer visible 












onDestroy() 


人 


图 3.2 生命 周期 流程 图 





(1) 添加 Activity 属性 
在 Mainifestxml 中 的 Activity 声明 中 加 入 android:configChanges="orientation|keyboard- 
Hidden" 属 性 ， 这 样 应 用 程序 就 可 以 在 屏幕 方向 或 者 键盘 状态 改变 时 作出 相应 的 处 理 。 本 实 
例 中 ， 实 现 如 下 : 
<activity 
android:configChanges="orientation|keyboardHidden" 
android:label="@string/app_name" 
android:name=" .Ex activityActivity" > 
(2) 变化 处 理 
添加 了 处 理 属 性 后 ， 当 屏幕 方向 改变 或 键盘 状态 改变 时 ， 系 统 会 自己 回调 Activity 中 
的 函数 进行 处 理 ， 函 数 如 下 : 


void onConfigurationChanged(Configuration newConfig) 


其 中 ， 参 数 newConfig 是 改变 后 的 状态 信息 。 需 要 注意 的 是 ， 在 onConfigurationChanged 
中 只 会 监测 应 用 程序 在 AnroidMainifest.xml 中 通过 android:configChanges="xxxx" 指 定 的 配 
置 类 型 的 改动 ， 对 未 指定 的 配置 改变 后 ， 不 会 调用 该 函数 进行 处 理 而 使 用 系统 默认 处 理 ， 
即 调用 onDestroy0 销 毁 当 前 Activity， 然 后 重启 一 个 新 的 Activity 实例 。 

在 本 实例 中 ， 我 们 先 不 对 其 作 任何 操作 ， 只 打印 改变 信息 ， 具 体 实现 如 下 : 


yy 
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01 public void onConfigurationChanged(Configuration newConfig) { 


02 super.onConfigurationChanged (newConfig); 

03 Log.i (TAG, "this is onConfigurationChanged"); 

04 if (newConfig.orientation == Configuration.ORIENTATION LANDSCAPE) 
{ 

05 // 横 屏 时 

06 Log.i(TAG，"this is ORIENTATION LANDSCAPE");  // 输 出 横 屏 提示 

07 } else if (newConfig.orientation == Configuration.ORIENTATION 
PORTRAIT) { 

08 // 竖 屏 时 

09 Log.i(TAG, "this is ORIENTATION PORTRRIT") ; // 输 出 竖 屏 提示 

10 } 

El 

2 // 检 测 实体 键盘 的 状态 : 推出 或 者 合 上 

13 if (newConfig.hardKeyboardHidden == Configuration. 
HARDKEYBOARDHIDDEN NO) { 

14 // 实 体 键盘 处 于 推出 状态 ， 在 此 处 添加 额外 的 处 理 代码 

15 Log.i(TAG，"this is HARDKEYBOARDHIDDEN NO") ;  // 输 出 有 键盘 提示 

16 } else if (newConfig.hardKeyboardHidden == Configuration. 
HARDKEYBOARDHIDDEN YES) { 

HD // 实 体 键盘 处 于 合 上 状态 ， 在 此 处 添加 额外 的 处 理 代 码 

18 Log.i (TAG，"this is HARDKEYBOARDHIDDEN YES"); // 输 出 无 键盘 提示 

19 } 

20 } 


其 中 ，01 行 ， 重 写 onConfigurationChanged 函数 ， 对 指定 的 变化 进行 自 定 义 处 理 ; 

04 一 10 行 ， 当 屏幕 方向 改变 时 ， 进 行 相应 处 理 ， 这 里 只 打印 信息 ; 

12 一 19 行 ， 当 键盘 状态 改变 时 ， 进 行 相应 处 理 ， 这 里 只 打印 信息 。 

(3) 运行 分 析 

使 用 上 面 的 方法 进行 处 理 后 , 我 们 在 模拟 器 中 使 用 Ctrl+F11 组 合 键 来 将 屏幕 方向 进行 
切换 测试 。 在 开始 的 竖 屏 ， 我 们 在 输入 框 中 输入 文字 ， 如 图 3.3 所 示 。 切 换 屏 幕 方向 后 ， 
显示 如 图 3.4 所 示 。 显 然 ， 输 入 框 中 的 内 容 没 有 改变 ， 数 据 保 存 完 好 。 再 看 看 ， 打 印 的 调 
试 信息 ，Activity 是 否 被 销毁 。 


一 一 一 一 一 一 -一 一 | 






全 21:57 
ER 


坚 切 换 不 销毁 
避风 三 21581 
Ex activity | 
横竖 切换 不 销毁 | 
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调试 的 日 志 信息 打印 如 图 3.5 所 示 ， 可 以 看 出 Activity 创建 运行 后 ， 没 有 被 再 次 销毁 。 
而 当 屏幕 方 向 改变 时 ， 调 用 了 我 们 实现 的 onConfigurationChanged0 函 数 进行 处 理 。 


























FID Application Tag Text 
56 1646 Com.oulngq,.ex acti... Ex activitvyActivity this is onCreate 

56 1646 com.oulng.ex acti... Ex activityActivity this is onStart 

78 1646 com.oulndq.ex acti... Ex activityActivity this is onResune 

95 1646 com.oulmna. ex acti... Ex activityActivity this is onConfiduracionChaneed 
17 1646 com.oulna. ex_acci..。 Ex activityActivity this is ORIENTATION LANDSCAPE 
26 1646 Com.oulng.ex acti... Ex activityActivity this is HARDKEYBOARDHIDDEN NO 
465 1646 com.oulnd.ex acti... Ex activityActivity this i3 onConfiqurationChanqed 
465 1646 Com.oulngq.ex acti... Ex activityActivity This is ORIENTATION LANDSCAPE 
465 1646 Com. oulndg. EX_acci..。 Ex activityActivity this is HARDKEYBOARDHIDDEN YES 
TE acConEiguarsacionchangea 
996 1646 com.oulnq.ex acti... Ex_activityhctivity this is ORIENTATION PORTRAIT 


016 1646 Com.oulngq.ex acti... Ex activityActivity this is HARDKEYBOARDHIDDEN YES 


图 3.5 横竖 屏 切换 不 销毁 


3.1.2 拨打 电话 


在 应 用 程序 中 ， 一 般 不 会 只 有 一 个 Activity， 在 多 个 Activity 之 间 进 行 跳 转 的 时 候 ， 大 
部 分 时 候 也 会 携带 相关 数据 。 在 这 一 小 节 中 ， 我 们 通过 调用 系统 电话 拨号 界面 ， 来 讲解 不 
同情 况 下 Activity 间 跳 转 的 处 理 。 


1. 界面 设计 





在 本 实例 中 ， 实 现 了 拨打 电话 和 发 送 邮 件 两 个 功能 ， 在 主 界面 中 给 出 功能 选择 按钮 ， 
如 图 3.6 所 示 。 当 选择 不 同 的 功能 时 ， 跳 转 到 对 应 的 详细 界面 。 例 如 ， 选 择 “拨打 电话 ” 
功能 ， 则 跳 转 到 新 界面 中 输入 需 拨打 电话 的 号 码 ， 并 且 有 返回 主 界面 和 跳 转 到 系统 拨号 界 
面 进行 电话 播 出 两 个 功能 选项 ， 如 图 3.7 所 示 。 

吕 EEETTTTT 部 开关 打 


me 
二 Ex activity intent 


GEE 


拨打 电话 





图 3.6 功能 选择 Activity 图 3.7 输入 号 码 Activity 
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2. 跳 转 拨号 


从 界面 设计 中 ， 可 以 看 出 我 们 将 使 用 自 定义 的 两 个 以 上 的 界面 Activity， 并 且 进 行 了 
多 次 不 同 Activity 的 跳 转 。 在 这 里 ， 我 们 首先 实现 从 自 定义 的 界面 跳 转 到 系统 拨号 界面 。 
(1) 创建 新 Activity 

在 我 们 使 用 Eclipse 创建 一 个 新 的 Android 项 目 时 , 系统 会 为 我 们 生成 很 多 必需 的 文件 
来 生成 初始 化 的 第 一 个 Activity。 当 我 们 需要 创建 一 个 新 的 Activity 时 ， 需 要 手动 创建 、 修 
改 3 个 文件 来 实现 ， 这 3 个 文件 分 别 是 : 


口 





新 建 布局 文件 : 在 res 目录 中 的 layout 子 目录 中 ， 新建 XML 文件 ， 如 图 3.8 所 示 。 
该 文件 作为 新 建 的 Activity 的 界面 布局 文件 ， 在 其 中 编写 该 Activity 的 布局 ,编写 
的 方法 与 规范 和 Eclipse 默认 建立 的 main.xml 文件 是 一 致 的 。 本 实例 在 layout 目录 
中 ， 新 建 布局 文件 call phone.xml， 内 容 如 下 : 


<?xml] version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/ 
android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:orientation="vertical" > 


<TextView 
> 


</LinearLayout> 

新 建 源 文件 : 在 src 目录 中 新 建 一 个 类 继承 至 Activity 类 , 在 Java 文件 中 实现 布局 
以 及 按键 的 处 理 等 ， 与 创建 的 第 一 个 Activity 是 一 致 的 。 本 实例 中 ， 创 建 了 
Input_ numActivity 类 来 实现 对 输入 号 码 拨打 电话 的 处 理 ， 如 图 3.8 所 示 。 

注册 声明 : 最 后 需要 在 AndroidManifest.xml 文件 中 注册 声明 我 们 新 建 的 Activity， 
只 需要 在 Application 标签 内 ， 添 加 该 Activity 即 可 。 在 本 实例 中 ， 新 建 Activity 
的 类 名 为 Input_numActivity， 声 明 如 下 : 


<xapplication 


android:icon="@drawable/ic launcher" 
android:label="@string/app name" > 
<activity android:name=".Input numActivity"/> 


</application> 


(2) 拨号 跳 转 

现在 我 们 已 经 新 建 了 如 图 3.7 的 界面 。 在 其 中 ， 我 们 输入 需 拨打 的 电话 号 码 ， 然 后 通 
过 “拨打 电话 ”按钮 来 实现 跳 转 到 系统 拨号 界面 ， 如 图 3.9 所 示 。Android 提供 了 Intent 来 
实现 这 样 的 跳 转 。 

Intent 中 文 译 成 目标 、 意 图 ， 用 于 对 执行 某 个 操作 的 一 个 抽象 描述 ， 包 括 动作 、 操 作 
数据 以 及 附加 数据 的 描述 。 在 Android 系统 中 , Intent 负责 提供 组 件 之 问 相互 调用 的 相关 信 
息 传递 ， 实 现 组 件 之 间 的 调用 耦合 。Intent 的 常用 构造 函数 有 如 下 儿 种 ， 分 别 定义 不 同 的 
意图 : 


Intent () 
Intent (String action) 
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Intent (String action, Uri uri) 
Intent (Context packageContext, Class<?> cls) 


DE 


@ 


眶 Package Explorer 53 全 lierarchy 号 硬 
Ey 


四 加 ractivity 
日 加 sx_activity_intent 
SB 


SB con. ouling ex_activity_intent 


时 时 gen [Generated Java Filss] 
市- 僵 hndroid 2.2 






由 E> drawable-hdpi 
由 GE dswable-ldpi 
WH ramable-ndpi 
EE] layout 
X) main. xml 
BB values 
9 Androidlanifest. xml 
proguard cfe 
BB project. properties 


图 3.8 新 建文 件 图 3.9 系统 拨号 


其 中 ， 参 数 action 是 定义 的 动作 ， 该 动作 可 以 是 系统 定义 的 也 可 以 是 自 定义 





的 。 在 本 


实例 中 ， 跳 转 到 系统 拨号 界面 使 用 系统 定义 的 动作 ACTION_DIAL。 系 统 还 有 很 多 其 他 的 
动作 定义 , 我 们 在 后 面 的 章节 中 会 逐步 涉及 。 参 数 uri 是 操作 数据 的 标识 符 ， 参数 package- 
Context 是 跳 转 的 上 下 文 context; 参数 cls 是 跳 转 到 的 组 件 的 Class 名 。 因 此 ， 拨 打 10086 


的 Intent 实现 如 下 : 
Intent (Intent.ACTION DIAL, Uri.parse("tel:10086")) 
在 跳 转 的 时 候 ，Activity 提供 了 常用 的 两 种 跳 转 方法 : 


void startActivity(Intent intent) 
void startActivityForResult (Intent intent, int requestCode) 


其 中 ， 第 一 种 方法 实现 一 个 活动 (Activity) A 到 另 一 个 活动 B 的 跳 转 ， 之 间 不 会 从 B 





传递 结果 到 A。 第 二 个 方法 实现 A 跳 转 到 B， 当 B 处 理 完成 后 ， 将 数据 结果 返回 
这 里 ， 只 需要 跳 转 到 系统 拨号 界面 ， 使 用 第 一 种 方法 。 
掌握 了 整个 实现 的 方法 ， 具 体 实 现代 码 如 下 : 


到 A。 在 


01 String phoneString = edt num.getText() .toString() > 
// 获 取 输 入 的 电话 号 码 
02 Pattern pattern = Pattern.compile("[0-9]*"); // 数 字 的 正则 表达 式 
03 if (pattern-matcher (phoneString) .matches ()) { // 判 断 号 码 是 否 都 是 数字 
04 // 调 用 系统 拨打 电话 
05 Uri uri = Uri.parse("tel:" + PhoneString) ; // 拨 号 的 URI 
06 Intent sys call Intent = new Intent (Intent.RACTION DIAL, uri); 
// 拨 号 意图 
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07 


startActivity(sys call Intent) : 
08 时 


// 实 现 跳 转 





其 中 ，01 一 03 行 ， 获 取 在 输入 框 中 的 号 码 ， 并 判断 该 输入 是 否 由 0 一 9 的 数字 组 成 ; 

04 一 07 行 ， 实 现 从 输入 界面 到 系统 拨号 界面 的 跳 转 ; 05 行 ， 定 义 拨打 的 号 码 ; 06 行 ， 
定义 了 拨号 的 Intent; 07 行 ， 实 现 跳 转 ; 

跳 转 的 结果 如 图 3.9 所 示 ， 可 以 很 明显 地 看 
为 10086， 只 需要 单 击 通话 按钮 就 可 以 播 出 电话 。 


3. 功能 跳 转 




















上 跳 转 到 系统 的 拨号 界面 并 且 拨打 的 号 码 


我 们 已 经 实现 了 从 输入 号 码 界面 到 系统 拨号 的 跳 转 ， 接 下 来 我 们 人 





岗 从 功能 选择 界面 
到 详细 功能 界面 的 实现 。 直 接 从 功能 选择 界面 到 详细 功能 界面 的 跳 转 实现 非常 简单 ， 只 需 
要 定义 Intent， 然 后 调用 startActivity0 即 可 实现 ， 具 体 如 下 : 
01 


Intent call intent=new Intent (Ex activity intentActivity.this,Input 
numActivity.class); 


02 startActivity(call intent); 

其 中 ，01 行 ， 定义 跳 转 的 Intent。 参 数 Ex_activity_intentActivity.this 表示 跳 转 前 的 上 
下 文 ; 参数 Input_ numActivity.class 表示 跳 转 到 的 组 件 。 即 从 功能 选择 界面 (Ex_activity_ 
intentActivity〉 跳 转 到 电话 输入 界面 (Input_numActivity); 

02 行 ， 直 接 启 动 跳 转 。 

这 样 直接 的 跳 转 很 简单 ， 我 们 需要 实现 的 是 从 详细 功能 界面 返回 功能 选择 界面 时 ， 显 
示 拨 打 的 电话 号 码 ， 实 现 效 果 如 图 3.10 所 示 。 


mpppreacno 


Ex activity Iintent 


拨打 电话 
发 送 邮 件 


拨打 的 号 码 是 : 10086 





图 3.10 返回 拨打 号 码 
(1) 功能 Activity 跳 转 
于 有 数据 返 























回 ， 我 们 使 用 另 一 个 跳 转 方法 startActivityForResult(Intent intent，int 


第 3 章 Android 应 用 程序 特性 








requestCode)。 其 中 ，intent 是 跳 转 的 操作 描述 ，requestCode 是 自 定 义 的 请 求 标 识 。 在 功能 
选择 Ex_activity_intentActivity 中 ， 单 击 拨打 电话 ， 实 现 如 下 : 


01 static final int CALL REQUEST=0; // 定 义 返 回 的 标识 

02 btn call.setOnClickListener (new OnClickListener() { // 实 现 按钮 单 击 监 听 

03 Q@Override 

04 public void onClick(View v) { // 单 击 事件 处 理 

05 Intent call intent=new Intent (Ex activity intentActivity. 
this,Input numActivity.class); 

06 // 有 返回 结果 的 跳 转 

07 startActivityForResult (call intent, CALL REQUEST); 

08 } 

09 癌 原 


其 中 ，01 行 ， 定 义 请 求 标识 ; 

02 一 04 行 ， 定 义 单 击 “ 拨 打 电 话 ” 按 钮 的 事件 监听 。 在 单 击 事件 onClickO 实 现 处 理 ; 

05 行 ， 定 义 跳 转 Intent; 

06 一 07 行 ， 实 现 有 返回 结果 的 跳 转 。 

(2) 返回 数据 

在 电话 输入 界面 (Input_numActivity) 拨打 完 电话 之 后 ， 将 拨打 的 号 码 返回 给 功能 选 
择 主 界面 。 这 样 的 跳 转 同样 使 用 Intent 来 进行 描述 。 在 Intent 中 使 用 Bundle 类 型 来 对 附加 
数据 进行 描述 。 

Bundle 是 类 似 于 哈 希 表 HashMap 的 类 型 ， 保 存 一 个 键 值 对 。 使 用 如 下 方法 来 获取 和 
添加 数据 : 

Object get (String key) 

void PutString (String key, String value) 

其 中 ， 参 数 key 是 键 名 ;参数 value 是 键 值 。 在 Intent 中 ， 对 附加 数据 Bundle 的 获取 
和 添加 ， 使 用 如 下 方法 : 


Bundle getExtras() 
Intent PutExtras (Bundle extras) 








其 中 ，get 方法 返回 Bundle 类 型 数据 ; 参数 extras 为 添加 的 Bundle， 返 回 为 Intent。 获 
得 数据 后 ， 返 回 上 一 个 Activity， 使 用 方法 : 


void setResult (int resultCode) 
void setResult (int resultCode, Intent data) 





其 中 ， 参 数 resultCode 是 结果 标识 ， 常 用 系统 定义 的 RESULT_CANCELED 或 者 
RESULT_OK。 参 数 data 是 返回 的 数据 。 

最 后 ， 需 要 特别 注意 的 是 在 setResult 后 ， 要 调用 finish0 销 毁 当前 的 Activity， 否 则 无 
法 返回 到 原来 的 Activity， 就 无 法 执行 原来 Activity 的 onActivityResult 函数 ， 从 而 停留 在 
当前 Activity， 没 有 反应 。 

掌握 了 返回 数据 的 方法 ， 在 本 实例 中 具体 实现 如 下 : 














01 void on Previous(){ 
02 Bundle bundle = new Bundle(); // 实 例 化 bundle 
03 String phoneString = edt num.getText () .toString(); 
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04 
05 
06 


07 
08 


// 获 取 输 入 的 电话 号 码 
bunqdle.putString ("PHONE NUM"，phoneString); // 号 码 保存 到 bundle 中 
Input numActivity.this.setResult (RESULT CANCELED, 
Input numActivity.this.getIntent() .putExtras 


(bundle)); // 设 置 返 回 的 结果 数据 
Input numActivity.this.finish(); // 结 束 当前 界面 


上 


其 中 ，02 一 04 行 ， 将 拨打 的 号 码 保存 到 bundle 中 ; 

05 一 06 行 ， 调 用 setResult 方法 返回 到 之 前 的 Activity 。 其 中 ， 标 识 为 
RESULT CANCELED， 数 据 Intent 中 添加 了 保存 了 号 码 的 bundle; 07 行 ， 调 用 finishO 销 
毁 当 前 Activity。 

(3) 返回 数据 处 理 

从 电话 输入 界面 (Input numActivity) 返回 到 功能 选择 界面 (Ex_activity_intentActivity) 
后 ， 接 下 来 实现 功能 界面 中 对 返回 数据 的 处 理 。 重 写 Activity 中 的 函数 : 


onActivityResult (int requestCode, int resultCode, Intent data) 




















其 中 ， 参 数 requestCode 就 是 跳 转 时 ， 函 数 startActivityForResult0 中 的 请 求 标识 
requestCode; 参数 resultCode 就 是 返回 时 ， 函 数 setResult0 中 的 结果 标识 resultCode; 参数 
data 是 具体 的 返回 数据 结果 。 

本 实例 中 ， 请 求 标识 为 CALL_REQUEST， 返 回 结果 标识 为 RESULT_CANCELED， 
返回 的 数据 只 有 拨打 的 电话 号 码 。 具 体 实现 如 下 : 





@Override // 实 现 界面 返回 处 理 方法 
Protected void onActivityResult(int requestCode, int resultCode, 
Intent data) { 
super.onActivityResult (requestCode, resultCode, data); 
if (requestCode 一 CALL REQUEST) { // 判 断 请 求 标识 是 否 为 电话 
if (resultCode == RESULT CANCELED) {  // 判 断 返 回 结果 标识 
Bundle bundle = data.getExtras(); 


// 获 取 完 整 返回 数据 data 
String phone num=bundle.getString ("PHONE NUM"); 

// 获 取 返 回 的 号 码 
Toast .makeText (this, "拨打 的 号 码 是 : "+phone_num，1000) . 
show (); // 显 示 返 回 的 号 码 


} 


其 中 ，01 一 03 行 ， 重 写 函 数 onActivityResult(); 

04 行 ， 判 断 请 求 标识 是 否 为 电话 跳 转 标识 CALL REQUEST; 

05 行 ， 判 断 结果 标识 是 否 为 标识 RESULT_ CANCELED; 

06 一 08 行 ， 从 数据 Intent 中 获取 附带 的 电话 号 码 ， 并 且 显 示 ， 效 果 如 图 3.10 所 示 。 


3J1.3 


活动 总 结 


在 本 节 中 我 们 介绍 了 Android 应 用 程序 中 使 用 最 多 也 最 重要 的 组 件 Activity。 我们 通过 
实例 讲解 了 Activity 的 生命 周期 以 及 横竖 屏 切换 时 的 处 理 ， 有 助 于 以 后 处 理 电 话 呼 入 或 者 
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电量 不 足 等 突 发 情况 下 对 当前 Activity 的 处 理 ; 讲解 了 多 种 情况 下 的 Activity 之 间 的 跳 转 ， 
包括 了 直接 跳 转 、 数 据 传递 跳 转 以 及 有 数据 返回 的 跳 转 ， 这 些 都 是 我 们 在 实际 应 用 程序 的 
编写 时 ， 经 常 需 要 处 理 的 问题 ， 希 望 大 家 能 熟练 掌握 。 同 时 也 简单 介绍 了 组 件 之 问 调用 的 
“信使 ”Intent， 在 后 面 的 章节 中 我 们 还 会 使 用 到 它 ， 逐 步 讲 解 使 大 家 加 深 对 Intent 的 理解 。 











3.2 Service 一 一 服务 


Service 是 Android 系统 中 提供 的 四 大 组 件 之 一 ， 虽 然 没 有 Activity 使 用 的 频率 高 ， 但 
是 在 应 用 程序 中 与 Activity 同等 重要 。 它 是 运行 在 后 台 的 一 种 服务 程序 ， 一 般 生 
长 ， 不 直接 与 用 户 进行 交互 ， 因 此 没有 可 视 化 的 界面 。 在 服务 中 ， 最 典型 的 应 用 实例 是 
乐 播 放 器 。 在 播放 器 中 ， 可 能 会 提供 一 个 或 多 个 Activity 界面 给 用 户 操作 ， 但 是 音乐 不 会 
因为 Activity 的 切换 而 停止 ， 这 时候 就 需要 服务 来 保证 实现 这 样 的 效果 。 在 后 面 的 多 媒体 
章节 , 我 们 会 详细 介绍 这 种 播放 器 的 实现 。 在 本 节 中 , 我 们 将 通过 实例 来 对 Service 的 两 种 
启动 方式 进行 讲解 分 析 。 

Service 是 不 能 自己 启动 运行 的 ， 需 要 通过 Activity 或 者 其 他 的 Context 对 象 来 调用 才 
能 运行 。 启 动 服务 有 两 种 方式 ， 分 别 是 Context.startService() 和 ContextbindService0。 这 两 
种 方式 在 启动 过 程 和 生命 周期 方面 是 有 区 别 的 。 下 面 ， 我 们 实现 一 个 服务 ， 并 分 别 使 用 这 
两 种 方式 进行 启动 。 





3.2.1 创建 服务 


由 于 Service 是 不 能 自己 启动 运行 的 ， 所 以 需要 手动 添加 代码 。 整 个 过 程 和 新 建 一 个 
Activity 类 似 。 


1. 注册 声明 


首先 需要 在 AndroidManifestxml 文件 中 注册 声明 我 们 新 建 的 Service， 只 需要 在 
application 标签 内 添加 该 Service 即 可 。 在 本 实例 中 ， 新 建 Service 的 类 名 为 LocalService， 
声明 如 下 : 


<application 
android:icon="@drawable/ic launcher" 
android:label="@string/app name" > 
<service android:name=".LocalService"></service> 
</application> 


2. 实现 Service 


然后 在 src 目录 中 新 建 一 个 类 继承 Service 类 即 可 。 在 Service 中 有 一 系列 与 其 生命 周 
期 相关 的 方法 ， 这 些 方法 主要 有 如 下 5 种 : 
口 abstract IBinder onBind(Intent intenb: 必须 实现 的 方法 ， 返 回 一 个 绑 定 的 接口 给 
Service。 


口 void onCreate0: 当 Service 第 一 次 被 创建 时 ， 调 用 该 方法 。 
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口 int onStartCommand(Intent intent int flags, int startId): 当 通 过 startService() 方 法 启动 

Service 时 ， 调 用 该 方法 。 

口 void onDestroy0: 当 Service 结束 不 再 使 用 时 ， 调 用 该 方法 。 

口 boolean onUnbind(Intent intent): 当 通 过 bindService() 方 法 启动 Service， 取 消 绑 定 
时 ， 调 用 该 方法 。 

3. 状态 通知 


在 对 Activity 的 状态 查看 时 ， 我 们 使 用 了 调试 打印 的 方法 ， 这 样 只 能 在 开发 工具 中 查 
看 ， 不 能 给 予 用 户 恰当 的 提示 。 接 下 来 ， 我 们 实现 在 状态 通知 栏 中 给 出 提示 信息 ， 步 又 
如 下 : 

(1) 获得 通知 栏 管理 器 

通知 栏 管理 器 是 系统 服务 的 一 部 分 ， 获 取 该 管理 器 实现 如 下 : 

NotificationManager mNM = (NotificationManager) getSystemService 

(NOTIFICATION SERVICE); 

管理 器 主要 用 于 显示 和 关闭 通知 ， 使 用 到 的 主要 方法 有 : 

notify(int id, Notification notification) 

notify(String tag, int id, Notification notification) 

这 两 个 方法 用 于 在 通知 栏 中 给 出 提示 。 其 中 ， 参 数 id 是 该 通知 的 唯一 标识 ， 参 数 
notification 是 一 个 通知 对 象 Notification 类 ， 不 能 为 NULL; 参数 tag 是 该 通知 的 字符 串 标 
识 ， 可 以 为 空 。 

cancel (int id) 


cancel (String tag, int id) 
cancelAll () 


这 3 个 方法 用 于 取消 显示 的 通知 。 其 中 ， 参 数 id 是 通知 的 唯一 标识 ; 参数 tag 是 该 通 
知 的 字符 串 标 识 ， 最 后 一 种 方法 取消 所 有 先前 显示 的 通知 。 

(2) 创建 通知 Notification 

具体 的 通知 内 容 通 过 构造 Notification 类 来 实现 。Notification 的 常用 构造 函数 有 : 


Notification() 
Notification(int icon, CharSequence tickerText, long when) 


其 中 ， 参 数 icon 是 通知 显示 图 标号 ; 参数 tickerText 是 状态 通知 栏 显 示 的 通知 文本 ; 
参数 when 是 通知 产生 的 时 间 。 例 如 ， 构 造 一 个 在 通知 栏 中 显示 “Hello” 的 状态 类 ， 实 现 
如 下 : 








int icon = R.drawable.icon; // 通 知 图 标 
CharSequence tickerText = "Hello"; // 状 态 栏 显示 的 通知 文本 提示 


long when = System.currentTimeMillis(); // 通 知 产生 的 时 间 ， 会 在 通知 信息 里 显示 


Notification notification = new Notification (icon,tickerText,when) ; 
在 通知 的 时 候 ， 不 仅仅 可 以 在 状态 栏 中 给 出 提示 ， 同 时 可 以 通过 声音 、 震 动 等 给 用 户 
以 明显 的 提示 ， 实 现 如 下 : 


notification.defaults |=Notification.DEFAULT SOUND; // 添 加 声音 
notification.defaults |= Notification.DEFAULT VIBRATE; // 添 加 震动 
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[2 


熟悉 了 整个 状态 通知 栏 的 使 用 方法 和 要 点 ， 在 本 实例 中 具体 的 状态 信息 通知 代码 如 下 : 


01 private NotificationManager mNM; // 定 义 状态 通知 栏 管理 器 


02 NotificationManager mNM = (NotificationManager) getSystemService 
(NOTIFICATION SERVICE); // 获 取 状 态 通知 栏 管理 器 

03 private void showNotification() { // 定 义 通知 栏 显示 方法 
04 CharSequence text = "Local service has started"; 

// 定 义 显示 文字 
05 Notification notification = new Notification(R.drawable.ic 

launcher, 
06 text, System.currentTimeMillis()); // 实 例 化 状态 通知 
07 PendingIntent contentIntent = PendingIntent .getActivity(this, 0, 
08 new Intent(this, Ex localServiceActivity.class), 0); 
// 定 义 通知 栏 单 击 事件 触 发 的 Intent (意图 ) 

09 notification.setLatestEventInfo(this, "Local Service", text, 
10 contentIntent); // 设 置 该 状态 通知 消息 的 单 击 事件 
下 于 INM.notify (R. string.Jocal _ service started, notification); 

// 通 知 栏 显 示 该 通知 
12 3 


其 中 ，01 一 02 行 ， 获 取 状 态 通 知 栏 的 管理 器 ; 

04 一 06 行 ， 构 造 一 个 状态 通知 。 显 示 内 容 是 Local service has started; 

07 一 08 行 ， 实 现在 通知 栏 中 单 击 该 通知 后 跳 转 到 Ex_localServiceActivity 界面 ; 
09 一 11 行 ， 实 现 将 通知 传递 给 通知 管理 器 ， 显 示 在 通知 栏 中 。 

4. Service 实 现 


为 了 更 方便 地 观察 在 服务 中 的 状态 变化 ， 我 们 在 相应 的 状态 给 出 通知 提示 并 打印 状 
整个 Service 具体 实现 如 下 : 


01 public class LocalService extends Service { // 继 承 Service 
02 private String TAG = "LOCALSERVICE"; // 定 义 打 印信 息 标 识 
03 private NotificationManager mNM; // 定 义 状态 通知 栏 
04 private final IBinder mBinder = new LocalBinder(); 
// 实 例 化 LocalBinder 
05 
06 public class LocalBinder extends Binder { // 继 承 Binder 
07 LocalService getService() { // 获 取 该 服务 ， 在 bind 方式 时 使 用 
08 return LocalService.this; 
09 } 
10 | 
3 
Ts GOverride // 实 现 bind 
3 public IBinder onBind (Intent intent) { 
14 Log.i(TAG, "this is onbind"); 
1 return mBinder; // 获 取 LocalBinder 类 
16 } 
7 
18 @Override // 实 现 创建 方法 
19 Public void onCreate() { 
20 mNM = (NotificationManager) getSystemService (NOTIFICATION_ 
SERVICE); // 获 取 通知 栏 管理 器 
2 Log.i(TAG, "this is oncreate”) > // 打 印 提示 
局 showNotification(); // 显 示 通 知 信息 
芝 3 } 
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24 

25 @Override // 实 现 开始 方法 

26 Public int onStartCommand (Intent intent, int flags, int startId) { 

芝 流 Log.i(TAG, "Received start id " + startId + ": " + intent); 

// 打 印 提示 

28 return START STICKY; 

29 } 

30 

3 @Override // 实 现 销毁 方法 

2 Public void onDestroy () { 

33 mNM.cancel (R.string.local service started); // 结 束 通知 栏 消 息 

34 Log.i(TAG, "this is ondestroy"); // 打 印 提示 

5 Toast.makeText (this, R.string.local service stopped, Toast. 
LENGTH SHORT) .show (); // 界 面 显示 提示 消息 

36 } 

37 

38 @Override // 实 现 解除 bind 方法 

39 public boolean onUnbind (Intent intent) { 

40 // TODO Auto-generated method stub 

41 Log.i(TAG, "this is onUnbind"); // 打 印 提示 

42 return super.onUnbind (intent); 

43 E 


其 中 ，01 一 10 行 ， 继 承 Service 基 类 ， 定 义 和 初 始 化 全 局 变量 ; 
11 一 16 行 ， 重 写 onBind0) 函 数 ， 打 印 该 状态 ; 

17 一 23 行 ， 重 写 onCreate0 函 数 ， 打 印 该 状态 并 在 通知 栏 通知 ; 
24 一 29 行 ， 重 写 onStartCommand() 函 数 ， 打 印 该 状态 以 及 id 号 ; 
30 一 36 行 ， 重 写 onDestroy0 函 数 ， 打 印 该 状态 并 取消 通知 ; 

37 一 43 行 ， 重 写 onUnbind0) 函 数 ， 打 印 该 状态 。 








3.2.2 ”开始 服务 方式 


1. 界面 设计 
Service 不 能 自己 启动 ， 所 以 a -个 Activity ee 
Service 的 启动 与 停止 。 在 界面 中 ， 只 需要 两 个 按钮 : “ 


启 服务 ”和 “停止 服务 ” 即 可 ， 效果 如 图 3 -11 所 示 。 
2. 启动 、 停 止 服务 


在 Activity 中 ， 使 用 startService 方式 启动 服务 直接 调 
用 方法 : 


startService(Intent service) 





其 中 ， 参 数 service 是 从 当前 上 下 文 Context 跳 转 到 需 图 3.11 Start 方式 开启 服务 
要 开启 服务 的 Intent。 本 实例 中 ， 具 体 实现 如 下 : 


startService (new Intent (Ex localServiceActivity.this,LocalService.class)); 


停止 服务 直接 调用 方法 : 


boolean stopService (Intent name) 
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其 中 ， 参 数 name 是 需要 停止 的 服务 的 Intent。 本 实例 中 ， 具 体 实现 如 下 : 


stopService (new Intent (Ex localServiceActivity.this,LocalService.class)); 


运行 分 析 
调试 运 


到 行 该 代码 ， 单 击 “ 开 启 


服务 ”按钮 ， 在 最 上 方 的 通知 栏 中 给 出 提示 信息 Local 


service has started， 效 果 如 图 3.11 所 示 。 单 击 “ 停 止 服务 ”按钮 ， 在 当前 给 出 短暂 提示 框 


Local service has stopped， 效 果 如 pe 3.12 所 示 。 当 开启 服务 后 ， 单 击 Back 键 ， 返 回 到 系统 
主 界面 ， 此 时 Activity 已 经 销毁 ，1 


CE 


EX_localservice 


开启 服务 


停止 服务 


Local service has stopped 





图 3.12 Start 方式 关闭 服务 


再 看 看 打印 状态 信息 的 结果 ， 如 图 


Mpplication 


Tag 


是 该 服务 依然 处 于 冯 


November 19, 2011 





运行 状态 ， 效 果 如 图 3 


于 Local service 
Local service has started 


See allyourapps 
Touch the Launchericon 


图 3.13 


3.14 所 示 。 


Text 





返回 主 界面 





3.13 所 示 。 


咒 丽 拓 15:38 


15:37 








ce 











com. ouling, ex_localService TOCALSERYICE chis ia oncreate 
com. ouling, ex_localService LOCALSERYICE Received start id 1: Intent { capccos.oulinqvex_localservice/.Localser 中 ce } 
com. ouling, ex_localService LOCALSERYICE Received start id 2: Intent { TI 站 } 
com. ouling. ex_localService LOCALSERYICE Received start id 3: Intent { caDecoaoulinq.ex localservice/.Localger 
com. oulingq, ex localService LOCALSERVICE this la ondestroy 
com. ouling. ex_localService LOCALSERVICE this 13 oncreate 
LOCALSERVICE Received start id 1: Intent { cap=coa.oulinq.ex_localservice/.Localservice } 
SeYCEaracrersp No teyboard for 14 0 






从 图 中 可 以 很 明显 地 看 出 ，Service 被 一 
台 运 行 。 如 果 一 个 Service 被 startService 方法 多 次 局 
而 onStart 方法 每 次 都 会 被 调用 ， 


Service 在 后 
会 调用 一 次 ， 














停止 时 只 需要 调 | 
管 启动 该 Service 


该 Service。 





的 Activity 是 


图 3.14 Start 方 式 打 印信 息 











但 是 系统 只 会 


/evetiars /deity, kcn, bin 





次 a Service。 并 有 日 ， 当 该 Service 


否 存在 ， 它 





个 Activity 调用 startService(0 方 法 启动 ， 该 
自动 ， 那 么 onCreate 方法 只 
创建 Service 的 一 


个 实例 ， 在 
启动 之 后 , 不 


都 会 一 直 运 行 ， 直 到 调用 stopService() 才 会 结束 
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3.2.3 ” 绑 定 服务 方式 1 


前 面 讲解 了 startService 方式 来 启动 一 个 服务 ， 接 Eu 


下 来 讲解 使 用 bindService 方式 启动 服务 。 
1. 界面 设计 


和 startService 方式 启动 服务 使 用 同一 个 Service 

> 在 界面 上 禁止 startService 方式 启动 和 停止 两 个 按 

|， 添 加 “bind 开启 服务 ”和 “bind 停止 服务 ”的 两 个 
et 效果 如 图 3.15 所 示 。 


启动 、 停 止 服 务 


Connected to local service 


(1) Activity 绑 定 

在 Activity 中 ， 使 用 bind 方式 启动 服务 直接 调用 
方法 : 

boolean bindService (Intent service, 图 3.15 bind 启动 服务 

ServiceConnection conn, int flags) 


其 中 , 参数 service 是 描述 跳 转 到 服务 的 Intent; 参数 conn 是 用 于 监测 服务 状态 的 接口 ; 
参数 flags 是 绑 定 的 操作 选项 ， 一 般 使 用 系统 定义 的 Oe BIND_AUTO_CREATE、 
BIND_DEBUG UNBIND 或 BIND NOT FOREGROUND。 在 本 实例 中 ， 具 体 的 实现 如 下 : 


bindService (new Intent (Ex localServiceActivity.this, 
LocalService.class), mConnection, Context.BIND AUTO CREATE); 


停止 服务 直接 调用 方法 : 


void unbindService (ServiceConnection conn) 





其 中 ， 参 数 conn 是 绑 定 时 检测 服务 状态 的 接口 ServiceConnection 类 。 

(2) 实现 ServiceConnection 

ServiceConnection 类 是 用 于 检测 服务 状态 的 接口 ， 实 例 化 该 类 ， 必 须 实现 如 下 两 个 
方法 : 


void onServiceConnected (ComponentName name, IBinder service) 
void onServiceDisconnected (ComponentName name) 


其 中 ， 当 服务 被 调用 时 将 调用 第 一 个 方法 ， 当 服务 停止 时 将 调用 第 二 个 方法 。 本 实例 


中 ，ServiceConnection 类 实现 如 下 : 
01 Private ServiceConnection mConnection = new ServiceConnection() { 
// 实 例 化 服务 检测 类 
02 Public void onServiceConnected (ComponentName className, IBinder 
service) { // 实 现 服务 调用 时 的 处 理 方法 
03 mBoundService = ((LocalService.LocalBinder)service). 
getService(); // 获 取 服 务 
04 Toast .makeText (Ex localServiceActivity.this, R.string. 


local service connected, 


。90 。 


第 3 章 ”Android 应 用 程序 特性 








05 Toast .LENGTH SHORT) .show();  // 界 面 显示 提示 

06 于 

07 

08 Public void onServiceDisconnected (ComponentName className) { 
// 实 现 服务 停止 时 的 处 理 方法 

09 mBoundService = null; 

10 Toast .makeText (Ex localServiceActivity.this, R.string. 

local zservice disconnected, 

il Toast.LENGTH SHORT) .show();  // 界 面 显示 提示 

主公 } 

13 下 


其 中 ，01 行 ， 实 例 化 一 个 ServiceConnection 对 象 ; 

02 一 07 行 ， 实 现 onServiceConnected() 方 法 ， 在 当前 界面 中 显示 已 连接 的 提示 信息 ; 

08 一 13 行 ， 实 现 onServiceDisconnected() 方 法 ， 在 当前 界面 中 显示 断 开 连接 的 提示 
信息 。 

运行 分 析 
调试 运行 该 代码 ， 当 单 击 “bind 开局 服务 ”按钮 后 ， 在 当前 界面 给 出 提示 框 Connected 

to local service， 并 且 在 最 上 方 的 通知 栏 中 给 出 提示 信息 Local service has started， 效 果 如 图 
3.15 所 示 。 单 击 “bind 停止 服务 ”按钮 ， 在 当前 给 出 短暂 提示 框 Local service has stopped， 
效果 如 图 3.16 所 示 。 当 开启 服务 后 ， 单 击 Back 键 ， 返 回 到 系统 主 界面 时 ，Activity 已 经 被 
销毁 ， 服 务 也 随 之 停止 ， 出 现 短 暂 提示 框 Local service has stopped， 效 果 如 图 3.17 所 示 。 





De . mr 


Ex localservice 


| 
Camera CarHome Contacts 


入 


De Email ”Ex_Joc 


bind 停 止 服务 


Local service has stopped 
Setting 





图 3.16 bind 停止 服务 图 3.17 返回 主 界面 


再 看 看 打印 状态 信息 的 结果 ， 如 图 3.18 所 示 。 
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com.ouling. ex_localService 


com. ouling. ex_localService 





图 3.18 bind 方式 打印 信息 


从 图 中 很 明显 地 看 出 ， 当 一 个 Service 被 一 个 Activity 通过 bindService 的 方法 绑 定 启 
动 ， 不 管 调用 bindService 几 次 ，onCreate 方法 都 只 会 调用 一 次 ，onBind 方法 只 调用 一 次 ， 
并 且 onStart 方法 始终 不 会 被 调用 。 当 连接 建立 之 后 ，Service 将 会 一 直 运 行 ， 直 到 Activity 
调用 unbindService 断 开 连接 ，Service 调用 onUnbind 方法 和 onDestroy 方法 来 停止 销毁 该 
Service。 使 用 bind 方式 启动 服务 ， 当 Activity 销毁 后 ， 调 用 bindService 的 Context 不 存在 
了 ， 系 统 将 会 自动 停止 Service， 对 应 的 onUnbind 和 onDestroy 方法 被 调用 。 





3.2.4 服务 总 结 





在 本 节 中 我 们 介绍 了 Android 应 用 程序 中 另外 一 个 重要 的 组 件 一 一 Service。 我 们 通过 
实例 ， 分 别 使 用 不 同 的 方式 Context.startService() 和 ContextbindService0 启动 同一 个 
Service， 并 详细 介绍 了 这 两 种 方式 启动 和 停止 服务 的 方法 以 及 各 自生 命 周 期 的 区 别 。 当 我 
们 只 是 想 启 动 一 个 后 台 服 务 长 期 进行 某 项 任务 ， 那么 使 用 startService 方式 便 可 以 完成 。 如 
果 我 们 想 要 与 正在 运行 的 Service 取得 联系 ， 一 般 使 用 bindService 方式 来 完成 。 

不 仅仅 如 此 , 还 有 一 个 需要 注意 的 问题 ， 那 就 是 Android 中 的 Service 组 件 和 标准 Java 
中 的 线程 Thread 的 区 别 。 虽 然 两 者 都 是 用 于 后 台 运 行 ， 但 是 这 两 者 毫 无 关系 。Service 是 
Android 的 一 种 机 制 , 它 是 运行 在 对 应 的 主 进程 的 main 线程 上 的 , 而 Thread 是 另外 开启 一 
个 线程 来 执行 一 些 异步 的 操作 。 


3.3 BroadcastReceiver 一 一 广播 


BroadcastReceiver 即 广播 接收 器 ， 是 Android 系统 级 别 的 事件 处 理 机 制 。 在 实际 应 用 
中 ， 我 们 经 常会 遇 到 点 亮 屏幕 、 接 收 到 短信 等 事件 ，Android 提供 了 BroadcastReceiver 机 
制 来 处 理 这 种 系统 级 的 事件 。 在 Android 系统 中 定义 了 很 多 标准 事件 的 Intent, 通过 广播 的 
方式 发 送 Intent 到 系统 中 的 所 有 应 用 ， 在 应 用 中 监听 到 该 广播 ， 使 用 广播 事件 对 应 的 广播 
接收 器 进行 处 理 。 当 然 ， 除 了 系统 标准 事件 外 ， 我 们 也 可 以 自 定义 广播 事件 。 在 本 节 中 ， 
我 们 通过 实例 介绍 自 定 义 广 播 和 系统 广播 的 使 用 。 





3.3.1 自 定 义 广 播 


广播 机 制 分 为 两 部 分 ,一 部 分 是 被 广播 的 Intent, 另 一 部 分 是 接收 该 Intent 的 广播 接收 
器 (BroadcastReceiver) 。 在 自 定义 广播 中 ， 我 们 需要 分 别 实现 这 两 部 分 。 
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1. 发 送 广播 Intent 
在 广播 接收 器 中 ， 通 过 Intent 中 不 同 的 动作 来 区 别 接收 到 的 广播 是 否 是 需要 处 理 的 ， 
所 以 Intent 使 用 其 构造 函数 : 


Intent (String action) 


除 此 之 外 ， 在 Intent 中 也 可 以 定义 其 他 附带 的 数据 ， 用 于 广播 接收 器 中 处 理 。 定 义 了 
需要 广播 的 Intent 后 ， 将 该 Intent 广播 到 系统 中 ， 使 用 Context 的 方法 : 


void sendBroadcast (Intent intent) 
void sendBroadcast (Intent intent, String receiverPermission) 
void sendOrderedBroadcast (Intent intent, String receiverPermission) 


其 中 ， 参 数 intent 是 需要 广播 的 Intent; 参数 receiverPermission 是 广播 接收 器 需要 的 
权限 。 

第 二 种 方法 要 求 应 用 程序 具有 一 定 的 权限 ， 才 能 接收 处 理 该 广播 ， 一 般 为 系统 标准 广 
播 使 用 。 

前 两 种 方法 发 送 的 广播 是 无 序 广 播 ， 所 有 的 广播 接收 器 以 无 序 方式 运行 ， 是 完全 异步 
的 。 往 往 在 同一 时 间接 收 。 这 样 效率 较 高 ， 但 是 意味 着 接收 者 不 能 终止 广播 数据 传播 。 

第 三 种 方法 发 送 的 广播 是 有 序 广播 ， 一 次 传递 给 一 个 广播 接收 器 ， 当 该 接收 器 处 理 完 
成 后 才 会 传递 给 下 一 个 接收 器 。 由 于 每 个 接收 器 依次 执行 ， 因 此 它 可 以 传播 到 下 一 个 接收 
器 ， 也 可 以 完全 终止 传播 该 广播 ， 从 而 使 其 他 接收 器 无 法 接收 到 该 广播 。 接 收 器 的 运行 顺 
序 可 由 匹配 的 意图 过 滤器 (intent-filter) 的 android:priority 属性 控制 。 发 送 广播 的 整个 过 程 
就 这 样 简单 ， 具 体 实 现 如 下 : 





01 static final String SELF ACTION = "com.ouing.ex broadcast.Internal"; 
// 定 义 意图 动作 

02 Intent intent = new Intent (SELF ACTION);  // 实 例 化 意图 

03 sendBroadcast (intent); // 发 送 广 播 


其 中 ，01 行 ， 自 定义 广播 动作 ; 

02 行 ， 构 造 最 基础 的 广播 Intent; 
03 行 ， 将 该 Intent 广播 到 系统 中 。 
2. 广播 接收 器 


新 建 一 个 类 继承 BroadcastReceiver 类 ， 就 可 以 实现 自己 的 广播 接收 器 。 在 Broadcast- 
Receiver 类 中 ， 必 须 实现 方法 : 

void onReceive (Context context, Intent intent) 

该 方法 用 于 实现 接收 到 广播 后 的 具体 处 理 。 其 中 , 参数 context 是 广播 接收 器 运行 的 上 
下 文 环境 ， 参 数 intent 是 接收 到 的 Intent。 

本 实例 在 广播 接收 器 中 ， 只 提示 接收 到 的 Intent 信息 ， 具 体 实现 如 下 : 


01 public class Self broadcast extends BroadcastReceiver{ 


// 继 承 基础 广播 接收 器 
02 Q@Override 
03 Public void onReceive (Context context, Intent intent) { 
// 接 收 的 处 理 方法 
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04 Log.i ("BROADCAST", 
tostring()); 

05 
tostring(), 

06 1 

UV 时 


Toast.makeText (context, 


"+intent. 


// 打 印 提示 


"Self broadcast onreceive "+tintent. 
// 显 示 提 示 


"Self broadcast onreceive 


1000) .show(); 


其 中 ，01 行 ， 定 义 自己 的 广播 接收 器 Self broadcast 继承 BroadcastReceiver 类 ; 
02 一 07 行 ， 实 现 onReceive0 方 法 ， 在 方法 中 提示 接收 的 Intent 信息 。 


3. 动态 注册 广播 
广播 接收 器 需要 注册 到 


应 用 程序 中 才 可 以 监听 广播 ， 并 使 用 该 接收 器 进行 处 理 。 广 播 


接收 器 可 以 动态 地 注册 到 应 用 程序 中 ， 并 且 可 以 根据 需要 动态 地 取消 掉 。 在 界面 中 ， 我 们 


需要 两 个 按钮 分 别 用 于 注册 
事件 ， 界 面 效 果 如 图 3.19 条 


Ex broadcast 四 


注册 自 定 义 广播 
取消 自 定义 广播 


reglster self broadcast 


发 送 自 定义 广播 


图 3.19 


(1) 注册 广播 


广播 和 取消 广播 ， 同 时 我 们 需要 一 个 按钮 来 发 送 自 定义 的 广播 








注册 自 定义 广播 


图 3.20 所 示 。 


unreglster self broadcast 


发 送 自 定义 广播 


图 3.20 取消 注册 自 定义 广播 





在 上 下 文 环境 中 注册 广播 ， 常 用 的 方法 有 : 


Intent 
Tntent 


registerReceiver (BroadcastReceiver receiver, IntentFilter filter) 
registerReceiver (BroadcastReceiver receiver, IntentFilter filter, 


String broadcastPermission, Handler scheduler) 


其 中 ， 参 数 receiver 是 注 


主 册 的 广播 接收 器 ; 


参数 filter 是 使 用 该 接收 器 处 理 的 广播 事件 


Intent 的 过 滤器 。 在 filter 中 定义 广播 事件 的 动作 ， 用 于 标识 需要 处 理 的 广播 事件 。 参 数 
broadcastPermission 是 接收 事件 Intent 需要 的 权限 ; 参数 scheduler 是 处 理 该 广播 事件 的 
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在 本 实例 中 ， 广 播 注册 实现 如 下 : 
01 static final String SELF ACTION= "com.ouing.ex broadcast.Internal"; 
// 定 义 动作 
02 selfBroadcast = new Self broadcast(); // 实 例 化 自 定义 广播 接收 器 
03 btn registself.setOnClickListener (new OnClickListener() { 
// 设 置 按钮 单 击 监 听 器 
04 Q@Override 
05 public void onClick(View v) { // 按 钮 单 击 处 理 方法 
06 registerReceiver(selfBroadcast, new IntentFilter 
(SELF ACTION)); // 注 册 广 播 
07 Log.i(TAG, "register self broadcast"); // 打 印 提示 
08 Toast.makeText (context, "register self broadcast", 
1000) .show (); // 界 面 显 示 提 示 
09 } 
10 ]) 7 


其 中 ，01 行 ， 定 义 了 过 滤器 中 广播 的 动作 ， 该 动作 与 被 广播 的 Intent 动作 是 一 致 的 ; 
02 行 ， 实 例 化 了 自 定义 的 广播 接收 器 ; 
06 行 ， 动 态 注册 了 广播 。 





在 上 下 文 环境 中 取消 注册 广播 ， 有 着 对 应 的 方法 : 


void unregisterReceiver (BroadcastReceiver receiver) 


其 中 ， 参 数 receiver 是 广播 接收 器 。 该 广播 接收 器 必须 与 注册 的 广播 接收 器 一 致 并 且 


不 能 为 空 。 在 本 实例 中 ， 取 消 注册 广播 实现 如 下 : 


01 selfBroadcast = new Self broadcast(); // 自 定义 广播 接收 器 

02 btn unregistself.setOnClickListener (new OnClickListener() { 

03 QOverride 

04 public void onClick(View v) { 

05 unregisterReceiver (selfBroadcast) ; // 注 销 自 定义 广播 接收 器 

06 Log.i(TAG，"unregister self broadcast");  // 打 印 提示 

07 Toast .makeText (context, "unregister self broadcast", 
1000) .show (); // 界 面 显示 提示 

08 } 

09 I 


其 中 ，01 行 ， 实 例 化 广播 接收 器 ， 与 注册 的 广播 接收 器 是 一 致 的 ; 
05 行 ， 取 消 注册 了 广播 接收 器 。 


4. 运行 分 析 


调试 运行 该 代码 ， 当 没有 注册 广播 时 ， 单 击 “ 发 送 自 定义 广播 ”按钮 ， 只 会 给 出 发 送 


广播 的 提示 ， 如 图 3.21 所 示 。 当 单 击 “ 注 册 自 定义 广播 ” 按钮， 显示 成 功 注册 的 提示 ， 如 
图 3.19 所 示 。 注 册 广 播 后， 再 发 送 自 定 义 广播 ， 不 仅仅 会 提示 发 送 广播 ， 广 播 接收 器 还 会 
提示 接收 到 的 Patent 信息 ， 如 图 3.22 所 示 。 当 取消 广播 之 后 ， 发 送 自 定义 广播 就 不 会 再 显 
示 广 播 接 收 器 的 提示 信息 。 

















这 样 的 整个 过 程 ， 在 输入 的 调试 信息 中 可 以 更 清晰 地 看 到 ， 如 图 3.23 所 示 。 
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四 有 


让 5 


Ex broadcast i 


Ex broadcast 
注册 自 定义 广播 注册 自 定义 广播 
取消 自 定义 广播 取消 自 定义 广播 


Self_broadcast onrecelve Intent { 
send self broadcast act=com.oulng.ex_broadcast.Internal } 


发 送 自 定义 广播 发 送 自 定义 广播 








图 3.21 发 送 自 定义 广播 图 3.22 ”接收 到 广播 
Application Tag Text 
com, ouling.ex_broadcest BROADCAST reqister self broadcast 
com. oulinq. ex broadcest BROADCAST send self broadcast 
com, ouling. ex_broadcast BROADCAST Self broadcast onreceive Intent { act=conm,ouing.ex broadoast. Internel } 
com, oulind. ex_broadcast BROADCAST unreqister self broadcast 
com. ouling. ex_broadcast BROADCAST send self broadcasc 


图 3.23 ”调试 信息 


3.3.2 系统 广播 





短信 广播 


广播 的 注册 方式 有 两 种 ， 一 种 是 在 代码 中 动态 注册 ， 另 一 种 是 在 AndroidManifest. xml 
中 静态 注册 。 自 定义 广播 一 般 使 用 动态 注册 ， 而 系统 广播 则 根据 需要 选择 使 用 动态 注册 还 
是 静态 注册 方式 。 

1. 动态 注册 


系统 广播 的 广播 接收 器 以 及 动态 注册 方式 和 我 们 自 定义 的 广播 在 使 用 上 是 一 样 的 ， 只 
是 广播 的 动作 已 经 由 系统 定义 ,而 且 大 部 分 的 系统 广播 都 是 需要 相应 的 权限 才能 接收 广播 。 
接 下 来 ， 以 最 常见 的 短信 广播 为 例 进 行 讲解 。 在 之 前 的 界面 中 ， 添 加 两 个 按钮 ， 分 别 用 于 
注册 短信 广播 和 取消 短信 广播 ， 界 面 实现 如 图 3.24 所 示 。 

(1) 权限 声明 

要 接收 系统 发 出 的 短信 广播 ， 必 须 有 短信 接收 权限 ， 在 AndroidManifest xml 中 声明 
如 下 : 


<uses-permission android:name="android.permission.RECEIVE SMS" /> 
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(2) 动作 定义 
在 系统 中 ， 对 接收 到 短信 的 广播 mtent 动作 定位 为 : 


static final String SMS ACTION = "android.provider.Telephony.SMS 
RECEIVED™"; 


实现 广播 的 动态 注册 和 取消 只 需要 将 自 定义 广播 中 的 动作 修改 为 该 动作 即 可 实现 。 动 
态 注册 和 取消 的 实现 效果 分 别 如 图 3.24 和 图 3.25 所 示 。 


昼 加 但 21:07 [二 态 赣 龟 21:21 


Ex broadcast EX broadcast” 


注册 系统 短信 广播 注册 系统 短信 广播 


取消 系统 短信 广播 取消 系统 短信 广播 


reglster Sms broadcast unreglster sms broadcast 


发 送 自 定义 广播 发 送 自 定义 广播 


图 3.24 注册 短信 广播 图 3.25 取消 短信 广播 





(3) 短信 测试 

在 Eclipse 中， 我们 可 以 完成 向 模拟 器 中 发 送 短信 和 拨打 电话 等 操作 。 选 择 Eclipse 的 
DDMS 界面 , 在 左边 栏 中 可 以 看 到 Emulator Control 界面 ,如 图 3.26 所 示 。 其 中 ,Incoming 
number 是 呼 入 模拟 器 的 号 码 ， 可 以 填写 任意 的 数字 串 ; 选择 SMS 选项 ， 即 可 在 Message 
框 中 输入 短信 的 内 容 ， 通 过 Send 按钮 发 送 到 模拟 器 中 。 

当 动态 注册 短信 广播 后 ,使 用 Eclipse 的 模拟 器 控制 端 向 模拟 器 中 发 送 短信 , 将 显示 
播 接 收 器 中 的 提示 信息 ， 如 图 3.27 所 示 。 从 提示 信息 中 ， 可 以 看 出 该 广播 还 有 附带 oo 
我 们 将 在 后 面 的 章节 中 ， 详 细 介 绍 如 何 读 取 短信 的 内 容 。 

2. 静态 注册 

(1) 实现 注册 

对 于 短信 这 样 的 系统 广播 , 更 常用 的 注册 方式 是 静态 注册 。 只 需要 在 AndroidManifest. 
xml 文件 中 声明 广播 组 件 。 声 明 的 广播 组 件 中 包括 了 广播 接收 器 的 名 称 、 广 播 接收 器 处 理 
广播 的 动作 。 在 本 实例 中 实现 如 下 : 
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nwator Control 5 = 日 
Date hone sy koe 百 
Ovoice 
SMS broadcast onrecelve Intent { 


和 act=androld.provider.Telephony 
se SM RECEVED (has extras]} 
发 送 自 定义 广播 
Send 


Location Controls 








图 3.26 发 送 短 信 图 3.27 接收 到 短信 广播 
01 <application 
02 android:icon="@drawable/ic launcher" 
03 android:1label="@string/app name" > 
04 <receiver // 广 播 接 收 器 标签 
05 android:name=".Sms broadcast" > // 接 收 器 名 称 
06 <intent-filter > 
07 <action android:name="android.provider.Telephony.SMS 
RECEIVED" /> // 接 收 器 处 理 动作 
08 </intent-filter> 
09 </receiver> 


10 </application> 


其 中 ，01 一 03 行 ， 已 有 的 应 用 程序 定义 ， 广 播 接收 器 
的 声明 在 应 用 程序 标签 内 ; 

04 一 05 行 ， 定 义 广播 接收 器 标签 以 及 广播 接收 器 的 名 
称 ， 名 称 和 动态 注册 名 称 一 样 ; 

06 一 08 行 ， 定 义 处 理 广播 的 动作 ， 动 作 名 称 和 动态 注 
册 名 称 一 致 。 

(2) 短信 测试 

我 们 同样 使 用 Eclipse 的 模拟 器 控制 端 给 模拟 器 发 送 
短信 进行 静态 注册 的 测试 ， 如 图 3.26 所 示 。 在 界面 中 ， 我 


们 屏蔽 动态 注册 时 的 两 个 按钮 。 模 拟 器 成 功 接收 短信 后 ， NT 二 
和 动态 注册 接收 短信 后 的 效果 相同 ， 如 图 3.28 所 示 。 
(3) 动态 注册 与 静态 注册 的 区 别 





在 Android 中 通过 动态 和 静态 方式 注册 广播 ， 在 收 到 
指定 的 Action 后 处 理 的 效果 是 相同 的 ,但 是 这 两 种 方式 注 
册 的 广播 的 生命 周期 是 有 区 别 的 。 


图 3.28 静态 注册 
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使 用 动态 方式 注册 的 广播 是 非常 驻 型 广播 ， 也 就 是 说 广播 的 生命 周期 跟 动态 注册 到 应 
用 程序 的 生命 周期 是 一 致 的 ， 即 应 用 程序 结束 后 ， 动 态 注册 的 广播 接收 器 不 再 接收 处 理 广 
播 。 而 静态 方式 注册 的 广播 是 常 驻 型 广播 ， 也 就 是 说 当 应 用 程序 关闭 后 ， 如 果 有 信息 广播 
来 ， 程 序 也 会 被 系统 调用 自动 运行 。 
在 本 实例 中 ， 使 用 动态 方式 注册 广播 接收 器 后 ， 在 不 取消 该 广播 接收 器 的 情况 下 ， 结 
束 该 应 用 程序 返回 到 主 界面 。 模 拟 器 成 功 接收 到 短信 后 ， 在 通知 栏 中 有 短信 提示 ， 但 是 没 
有 我 们 实现 的 广播 接收 提示 , 效果 如 图 3.29 所 示 。 同 时 , 使 用 静态 方式 注册 广播 接收 器 后 ， 
结束 该 应 用 程序 返回 主 界面 。 当 成 功 接收 到 短信 后 ， 在 主 界面 中 显示 我 们 实现 的 广播 接收 
提示 ， 效 果 如 图 3.30 所 示 。 
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图 3.29 动态 注册 方式 图 3.30 静态 注册 方式 


3.3.3 ”广播 接收 器 总 结 


在 本 节 中 ， 我 们 介绍 了 四 大 组 件 中 的 BroadcastReceiver， 它 不 做 什么 事 ， 仅 是 接收 广 
播 公告 并 作出 相应 的 反应 。 我 们 通过 实例 ， 分 别 介 绍 了 自 定义 广播 和 系统 广播 接收 器 的 使 
用 ， 以 及 动态 注册 和 静态 注册 的 区 别 。 使 用 动态 方式 注册 的 广播 是 非常 驻 型 广播 ， 应 用 程 
序 关 闭 后 不 再 处 理 该 广播 ;而 静态 方式 注册 的 广播 是 常 驻 型 广播 ， 当 应 用 程序 关闭 后 ， 同 
样 可 以 处 理 该 广播 。 























3.4 消息 处 理 


在 Android 系统 中 遵循 单线 程 模型 , 即 Android 应 用 程序 的 UI 操作 并 不 是 线程 安全 的 
所 有 UI 操作 必须 在 UI 线程 中 执行 ， 所 有 其 他 线程 是 不 允许 更 改 UI 界面 的 。 但 是 ， 当 我 
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们 需要 进行 一 个 耗 时 的 操作 ， 如 联网 读 取 数 据 、 读 取 本 地 较 大 文件 时 ， 这 些 操 作 又 不 能 够 
放 在 主线 程 中 。 如 果 你 放 在 主线 程 中 的 话 ， 界 面 会 出 现 假死 现象 。Android 作为 实时 操作 
系统 ， 当 发 现 5 秒 钟 还 没有 完成 的 话 ， 会 发 出 一 个 错误 提示 “强制 关闭 ”。 这 时 候 ， 我 们 
需要 把 这 些 耗 时 的 操作 放 在 一 个 子 线程 中 ， 同 时 需要 根据 子 线程 的 进度 更 新 UI 界面 。 
Android 系统 提供 了 消息 处 理 机 制 来 解决 这 一 问题 。 





3.4.1 进度 条 更 新 


Google 在 Android 系统 中 通过 Looper、Handler 来 实现 消息 循环 机 制 。 其 消息 循环 是 
针对 线程 实现 的 ， 即 每 个 线程 都 可 以 有 自己 的 消息 队列 和 消息 循环 。 其 中 ，Looper 负责 管 
理 线 程 的 消息 队列 和 消息 循环 ; Handler 的 作用 是 把 消息 加 入 特定 的 消息 队列 中 , 并 分 发 和 
处 理 该 消息 队列 中 的 消息 。 接 下 来 ， 我 们 通过 更 新 进度 条 来 介绍 Handler 的 使 用 。 





1. 界面 设计 本 肌 有 7 
本 实例 实现 进度 条 的 更 新 ,每 间隔 1 秒 进度 条 前 进 


Ex handler 


5%; 当 进 度 条 达到 100% 时 ， 每 间隔 1 秒 进度 条 回 退 
5%。 在 界面 中 ， 只 需要 一 个 进度 条 ， 实 现 如 图 3.31 
所 示 。 


2. 进度 条 更 新 


(1) 创建 Looper 

Activity 是 一 个 UI 线程 , 运行 于 主线 程 中 , Android 
系统 在 启动 时 会 为 Activity 创建 一 个 消息 队列 和 消息 循 
环 (Looper) 。 所 以 ,一般 情况 下 我 们 不 用 创建 和 设置 
Looper。 但 是 ， 创 建 非 UI 线程 默认 是 没有 消息 循环 和 
消息 队列 的 ， 如 果 想 让 该 线程 具有 消息 队列 和 消息 循 
环 , 就 需要 在 线程 中 首先 调用 Looper.prepare0 来 创建 消 
息 队 列 ， 然 后 调用 Looper.loop0 进 入 消息 循环 。 

(2) Handler 实现 

Handler 负责 分 发 和 处 理 消息 循环 中 的 消息 。 其 中 ， 实 现 一 个 Hanler 类 ， 必 须 实现 
Handler 中 的 消息 处 理 函数 : 


Void handleMessage (Message msg) 


其 中 ， 参 数 msg 是 在 消息 队列 中 的 消息 类 Message， 其 中 包含 描述 和 任意 数据 对 象 ， 
其 中 使 用 Message 类 中 的 what 变量 来 定义 消息 代码 ， 以 使 收 件 人 能 识别 此 消息 。 

在 处 理 函 数 中， 我 们 接收 两 类 信息 ， 标 识 分 别 是 INC 和 DEC。 接 收 到 相应 的 信息 后 ， 
进度 条 进行 增长 和 减少 。 具 体 实现 如 下 : 





图 3.31 进度 条 更 新 





01 final int INC = 1; // 定 义 增加 的 消息 标识 
02 final int DEC = 2; // 定 义 减少 的 消息 标识 
03 Handler handler = new Handler() { // 实 例 化 Handler 

04 Q@Override // 重 写实 现 消息 处 理 方法 
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05 public void handleMessage (Message msg) { 

06 switch (msg.what) { // 判 断 接 收 到 的 消息 

07 case INC: // 增 加 消息 处 理 

08 bar .incrementProgressBy (5) ; // 进 度 条 增加 5% 

09 Log.i(TAG, "Thread id "+Thread.currentThread(). 
getId()+",handler INC");// 打 印 线 程 号 

10 break; 

直下 case DEC: // 减 少 消息 处 理 

12 bar.incrementProgressBy (-5) ; // 进 度 条 减少 5% 

3 Log.i(TAG, "Thread id "+Thread.currentThread () . 
getId()+",handler DEC") 7 

14 break; 

2 default: 

16 break; 

主子 } 

18 

9 ji 


其 中 ，01 一 02 行 ， 定义 了 消息 的 标识 ， 分 别 用 于 标识 增长 还 是 减少 的 消息 ; 

03 行 ， 实 例 化 一 个 消息 处 理 类 Handler; 

04 一 05 行 ， 重 写 消息 处 理 函数 handleMessage(); 

07 一 10 行 ， 判 断 消息 ， 当 是 增长 信息 时 ， 进 度 条 增长 并 打印 该 线程 号 和 消息 号 ; 

11 一 14 行 ， 判 断 消息 为 减少 信息 时 ， 进 度 条 进度 减少 并 打印 该 线程 号 和 信息 号 。 

(3) 消息 发 送 线程 

接 下 来 我 们 需要 新 建 一 个 线程 用 于 完成 耗 时 的 操作 ， 并 及 时 向 消息 循环 队列 中 发 送 消 
息 包 。 使 用 Handler 实例 来 进行 发 送 消息 包 ， 常 用 的 方法 : 

boolean sendEmptyMessage (int what) 

boolean sendMessage (Message msg) 


boolean sendMessageAtTime (Message msg, long uptimeMillis) 
boolean sendMessageDelayed(Message msg, long delayMillis) 


其 中 , 第 一 种 方法 表示 发 送 一 个 只 有 what 值 的 消息 ; 第 二 种 方法 表示 立即 发 送 一 个 消 
息 ， 参 数 msg 是 发 送 的 消息 ;第 三 种 方法 表示 在 指定 的 时 间 发 送 消息 ， 参 数 uptimeMillis 
指定 了 该 时 间 ， 第 三 种 方法 表示 延迟 一 段 时 间 后 发 送 消息 ， 参 数 delayMillis 指定 了 延迟 
时 间 。 

熟悉 了 发 送 消息 的 方法 后 ， 在 消息 发 送 线程 中 具体 实现 如 下 : 





01 Thread handlerBarThread = new Thread(new Runnable() { // 新 线程 
02 @Override 
03 public void run() { // 线 程 运 行 方法 
04 // 进 度 条 增长 
05 for (inti=07i<20&&is running;i++){ 
06 ET a 
07 Thread.sleep (1000) : // 线 程 暂停 1s 
08 Message msg = new Message(); // 实 例 化 消息 
09 msg.what = INC; // 消 息 内 容 
10 handler .sendMessage (msg); // 发 送 消 息 
证 小 Log-i (TAG, "Thread id "+Thread.currentThread(). 

getId()+", sendmessage INC") 7 

// 打 印 输出 发 送 详 细 的 线程 号 

和 } catch (Exception e) { 
3 // TODO: handle exception 
14 } 
19 让 
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16 // 进 度 条 减少 

FA 

18 } 

19 D2 

其 中 ，01 行 ， 新 建 一 个 线程 ; 

02 一 03 行 ， 实 现 新 线程 运行 的 rm0) 函 数 ; 

04 一 15 行 ， 发 送 20 个 进度 条 增长 消息 ， 每 次 消息 间隔 时 间 为 1 秒 。 

(4) 运行 分 析 

调试 运行 该 代码 ， 我 们 可 以 看 到 进度 条 每 隔 1 秒 前 进 一 些 ， 当 达到 百分之百 后 ， 逐 步 
减少 ， 效 果 如 图 3.31 所 示 。 我 们 再 看 看 输出 的 调试 信息 ， 如 图 3.32 所 示 。 


Tag Text [4 


HANDLER onc! thread id 1} 

HANDLER Thread id 6,sendmessaqe INC 

HANDLER Thread id 1,handler INC 
HANDLER Thread 1d 8,senduessage INC 

HANDLER Thread id 1,handler INC 

HANDLER Thread id 6,sendnessage INC 

HANDLER Thread id 1,handler INC 

HANDLER Thread 1d 8,sendaessaqe INC 

HANDLER Thread id 1,handler INC 


图 3.32 Handler 调试 信息 


我 们 可 以 看 出 ，Activity 在 创建 函数 onCreate0 时 的 线程 号 是 1。 发 送 消息 的 线程 号 是 
8， 而 Handler 处 理 线程 号 是 1。 可 以 看 出 消息 处 理 是 在 主线 程 中 处 理 的 ， 所 以 在 消息 处 理 
函数 中 可 以 安全 地 调用 主线 程 中 的 任何 资源 ， 包 括 刷 新 界面 。 工 作 线程 和 主线 程 运行 在 不 
同 的 线程 中 ， 所 以 必须 要 注意 这 两 个 线程 间 的 竞争 关系 ， 发 送信 息 和 处 理 消 息 不 一 定 会 交 
错 进行 。 发 送 多 个 信息 后 ，Handler 才 逐 个 处 理 信 息 。 


3. View 类 更 新 方法 


对 于 在 线程 中 刷新 一 个 View 为 基 类 的 界面 , 还 可 以 使 用 postInvalidate() 方 法 来 处 理 而 
不 使 用 Handler 来 实现 。 使 用 的 方法 有 : 


void postInvalidate() 

void postInvalidateDelayed(long delayMilliseconds, int left, int top, 
int right, int bottom) 

void postInvalidateDelayed(long delayMilliseconds) 


其 中 ， 第 一 种 方法 表示 立即 执行 View 更 新 。 后 两 种 方法 表示 延迟 执行 。 在 本 实例 中 ， 
使 用 更 新 View 的 方法 ， 具 体 实现 如 下 : 


01 Thread postBarThread=new Thread (new Runnable() { 

02 Q@Override 

03 public void run() { 

04 for(int i =0;i<20gg&is running;i++){ 

05 Er 

06 Thread.sleep (1000); // 线 程 暂 停 1s 

07 bar.incrementProgressBy (5); // 进 度 条 增加 5% 

08 bar.postInvalidate(); // 调 用 方法 通知 UI 更 新 

09 Log.i(TAG, "Thread id "+Thread. currentThread () . 
getId()+" ,Postinvalidate "); 

10 } catch (Exception e) { 

3 // TODO: handle exception 

hb Thread.currentThread() .interrupt (); 


"10s 
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13 } 

14 } 

FE } 

16 六 必 

其 中 ，04 一 09 行 ， 实 现 界面 的 更 新 ; 

07 行 ， 实 现 进度 条 的 增长 设置 ; 

08 行 ， 实 现 UI 更新。 实现 的 增长 效果 和 Handler 实现 的 效果 相同 ， 如 图 3.31 所 示 。 但 是 
实现 的 原理 是 不 一 样 的 , 从 调试 信息 中 , 可 以 看 出 只 有 线程 9 在 通知 UI 更 新 , 如 图 3.33 所 示 。 


Tag Text 
HANDLER oncreate thread id 1 

HANDLER Thread id 9,postinvalidate 
HANDLER Thread id 9,postinvalidate 
HANDLER Thread id 9,postinvalidate 
HANDLER Thread id 9,postinvalidate 
HANDLER Thread id 9,postinvalidate 
HANDLER Thread id 9,postinvalidate 
HANDLER Thread id 9,postinvalidate 
HANDLER Thread id 9,postinvalidate 


图 3.33 postInvalidate 调试 信息 
虽然 通过 这 种 方法 可 以 实现 View 为 基 类 的 界面 更 新 ， 但 是 推荐 的 方法 是 通过 一 个 
Handler 来 处 理 这 些 信息 。 在 一 个 线程 的 run 方法 中 调用 Handler 对 象 的 sendMessage 方法 
来 实现 ，Android 程序 内 部 维护 着 一 个 消息 队列 ， 会 轮 询 处 理 信息 。 


3.4.2 搜索 SD 卡 文件 


Android 中 除了 提供 了 Handler 的 消息 循环 机 制 外 , 还 提供 了 一 种 有 别 于 线程 的 处 理 方 
式 一 一 AsyncTask〔 异 步 任务 ) 来 处 理 耗 时 操作 。 接 下 来 ， 我 们 通过 搜索 SD 卡 文件 来 介绍 
AsyncTask 的 使 用 。 

1. 界面 设计 

我 们 根据 输入 的 文字 在 SDF 卡 中 搜索 文件 名 中 含有 
该 文字 的 所 有 文件 ， 然 后 将 搜索 结果 显示 给 用 户 。 界 面 实 
现 比较 简单 ,只 需要 文字 输入 框 和 搜索 按钮 ,效果 如 图 3.34 
所 示 。 


2. AsyncTask 实 现 








AsyncTask 是 Android 系统 提供 的 异步 处 理 类 ， 用 于 


(1) 实例 AsyncTask 

在 AsyncTask 的 抽象 类 中 定义 了 3 种 泛 型 : Params、 
Progress 和 Result。 抽 象 类 表示 如 下 : 

new AsyncTask<Params, Progress, Result> 图 3.34 文件 搜索 界面 

其 中 , 参数 Params 是 启动 任务 执行 的 输入 参数 ; 参数 Progress 是 后 台 任 务 执行 的 进度 
百分比 ; 参数 Result 是 后 台 执 行 任务 最 终 返回 的 结果 。 

为 了 实现 一 个 异步 任务 ， 可 以 分 为 4 步 ， 使 用 4 个 方法 来 实现 : 








有 
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OnPreExecute () 

doInBackground (Params...) 
onProgressUpdate (Progress...) 
onPostExecute (Result) 


接 下 来 ， 我 们 来 实现 这 4 个 方法 。 

(2) onPreExecute 

该 方法 在 执行 实际 的 后 台 操 作 前 被 UI 线程 调用 。 一 般 在 该 方法 中 做 一 些 准备 工作 。 
例如 ， 在 本 实例 中 ， 在 界面 上 显示 一 个 进度 条 。 具 体 实现 如 下 : 


01 Protected void onPreExecute() { 

02 Log.i(TAG, "onPreExecute Thread id "+Thread.currentThread () 
.getId()); // 打 印 线程 号 

03 dialog = ProgressDialog.show( 

04 Ex SDAsyncTaskActivity.this, "", 

05 "正在 扫描 SD 卡 , 请 稍 候 . . . .") : // 实 例 化 进度 对 话 面板 

06 super.onPreExecute (); 

07 上 

其 中 ，01 行 ， 实 现 onPreExecute() 方 法 ; 六 二 一 


03 行 ， 在 界面 中 显示 进度 条 ， 实 现 效果 如 图 3.35 所 示 。 
(3) doInBackground(Params...) - 
该 方法 在 onPreExecute0 方 法 执行 后 马上 执行 。 该 方法 运行 在 
新 的 后 台 线 程 中 , 用 于 完成 耗 时 的 后 台 操 作 工 作 。 该 方法 是 抽象 方 
法 ， 在 子 类 必须 实现 。 

其 参数 Params 即 是 在 实例 化 AsyncTask 时 的 泛 型 Params， 而 
且 返 回 的 数据 是 AsyncTask 中 的 泛 型 Result。 同时 在 该 方法 中 可 以 
调用 publishProgress() 方 法 来 更 新 实时 的 任务 进度 Progress, 在 本 实 
例 中 ,我 们 将 在 该 方法 中 ， 实 现 对 SD 卡 文件 名 中 包含 输入 文字 的 





文件 的 搜索 ， 有 具体 实现 如 下 : 图 3.35 搜索 进行 时 
01 Protected String doInBackground(Integer... params) 1{ 
02 Log.i(TAG, "doInBackground Thread id "+Thread.currentThread () . 
getId()); // 打 印 线 程 号 
03 if (landroid.os.Environment .getExternalStorageState() 
04 -equals (android.os.Environment .MEDIA MOUNTED)) { 
05 // 判 断 SD 卡 是 否 已 准备 就 绪 
06 } else { 
07 if (!editText.getText () .toString() .equals("")) { 
// 判 断 输入 不 为 空 
08 filelist.clear(); // 清 除 上 一 次 的 搜索 文件 列表 
09 return Search Files(Environment 
10 .getExternalStorageDirectory ()); 
// 调 用 文件 搜索 方法 
2 } 
12 } 
3 return null; 
14 } 


其 中 ，01 行 ， 实 现 doImBackground() 方 法 ; 
03 一 05 行 ， 检 测 SD 卡 是 否 可 用 。 当 不 可 用 时 ， 不 做 任何 操作 。 关 于 SD 卡 的 操作 ， 
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在 后 面 的 数据 存储 章节 将 有 更 详细 的 介绍 ; 

06 一 11 行 ， 当 SD 卡 可 用 时 ， 调 用 文件 搜索 的 方法 Search_Files0 进 行 搜索 。 

在 文件 搜索 方法 中 ， 我 们 只 需要 遍历 SD 卡 中 所 有 文件 ， 将 所 有 文件 的 文件 名 与 输入 
的 文字 进行 匹配 ， 当 文件 名 中 包含 了 输入 的 文字 ， 则 将 该 文件 名 保存 起 来 。 文 件 搜索 方法 
具体 实现 如 下 : 





01 public String Search Files(File filePath) { // 文 件 搜索 方法 
02 File[] files = filePath.listFiles(); 
// 获 取 该 路 径 下 的 所 有 文件 以 及 文件 夹 
03 String tempString=editText.getText() -toString() - 
toLowerCase () 
// 将 输入 内 容 转 为 小 写 
04 if (files != null) { 
05 for (int i = 0; i < files.length; i++) { 
ne 文件 及 文件 夹 
06 if (files[i].isDirectory()) 
7 7 基 染 为 文件 严 ， 则 递归 调用 文件 搜索 方法 
07 Search Files(files[i]); 
08 } else { 
09 // 匹 配 文件 名 
10 if(files[i] .getName() .toLowerCase () .contains 
(tempString) ) { 
I filelist.add(files[i] .getAbsolutePath ()+"\n"); 
2 } 
13 } 
14 } 
15 |! 
16 return filelist.toString() ;// 返 回 搜索 到 的 文件 列表 
2 } 


其 中 ，02 行 ， 获 取 文 件 夹 flePath 中 的 所 有 文件 以 及 文件 夹 ; 

05 一 08 行 ， 判断 File 是 否 为 文件 夹 ， 当 是 文件 夹 时 ， 递 归 调 用 Search_Files() 方 法 ， 继 
续 裔 历 下 一 层 目录 ; 

09 一 12 行 ， 当 File 为 文件 时 ， 匹 配 文件 名 中 是 否 含有 输入 文字 ， 如 果 含有 则 保存 到 
filelist 中 。 

(4) onProgressUpdate(Progress...) 

该 方法 在 每 次 调用 publishProgress() 方 法 后 被 UI 线程 调用 。UI 线程 调用 该 方法 在 界面 
上 展示 任务 的 进展 情况 ,通常 情况 下 ， 是 对 进度 条 进行 更 新 。 本 实例 中 , 没有 实现 该 方法 。 

(5) onPostExecute(Result) 

该 方法 在 doInBackground() 执 行 完 成 后 被 UI 线程 调用 。UTI 线程 调用 该 方法 获取 得 到 
后 台 的 计算 结果 Result， 并 对 结果 进行 处 理 。 本 实例 中 ， 我 们 显示 出 搜索 的 结果 ， 有 具体 实 
现 如 下 : 


01 Protected void onPostExecute (String result) { 
02 Log.i(TAG, "onPostExecute Thread id "+Thread.-currentThread () . 
getId()); // 打 印 线程 号 
03 dialog.dismiss(); 
04 if (editText.getText() .toString() .equals("")) { 
// 判 断 输入 是 否 为 空 
05 Toast .makeText (Ex SDAsyncTaskActivity.this, 
06 "请 输入 搜索 的 文件 名 "，1000) . show () ; 
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// 输 入 为 空 ， 则 提示 输入 搜索 文件 
07 } else { 


08 new AlertDialog.Builder(Ex SDAsyncTaskActivity.this) 
09 .setTitle ("SD 卡 搜索 结果 ") 

10 .setMessage (result) 

3 -create () .show() // 创 建 提示 框 显示 搜索 的 结果 
1 人 2 有 

3 super.onPostExecute (result); 

14 } 

其 中 ，01 行 ， 实 现 onPostExecute() 方 法 ; 97 


04 一 07 行 ， 判 断 输 入 的 文字 ， 如 果 输 入 为 空 则 提示 
输入 搜索 文件 ; 

08 一 11 行 ， 实 例 一 个 提示 框 ， 显 示 搜 索 的 结果 。 效 果 
如 图 3.36 所 示 。 


(6) 运行 AsyncTask [© 5D 卡 搜索 结 
通过 上 面 的 4 步 ， 我 们 实现 了 一 个 异步 任务 的 完整 [mntsdcard/DCIM/. 
的 操作 过 程 。 最 后 ， 运 行 该 AsyncTask， 使 用 方法 : oben ate 
,Vmntsdcard/address.xml 
public final AsyncTask<Params, Progress, , /mnt/sdcard/sdfile.xml 


Result> execute (Params... params) /mnt/sdcard/dqcx.mp3 
, /mnt/sdcard/dqcx.Irc 


其 中 ， 参 数 params 是 AsyncTask 中 的 具体 输入 。 | 


3. 运行 分 析 

调试 运行 该 代码 。 例 如 搜索 文件 名 中 含有 “d” 字 母 
的 文件 ， 整 个 过 程 如 图 3.35 和 3.36 所 示 。 查 看 调试 输出 本 
结果 ， 如 图 3.37 所 示 。 从 结果 中 ， 我 们 可 以 很 明显 地 看 本 
出 ， AsyncTask 的 处 理 过 程 分 别 是 : onPreExecute()、 doInBackground(Params...)、 


onProgressUpdate (Progress...)、onPostExecute(Result)4 步 。 并 日 ，doInBackground0 方 法 运 
行 的 线程 号 为 9， 其 他 方法 都 运行 在 主线 程 中 。 





! Tag Text 

lex_SDAsyncTask ASYNCTASK onclik start Thread id 1 
I.ex_SDAsyncTask ASYNCTASK onpreExecute Thread id 1 
hex_SDAsyncTask ASYNCTASK ‘onClick stop Thread id 1 
tex_SDAsyncTask ASYNCTASK doInBackqround Thread id 9 
.ex_SDAsyncTask ASYNCTASK onpostExecute Thread id 1 


图 3.37 AsyncTask 调试 输出 
3.4.3 ”异步 处 理 总 结 


在 本 节 中 我 们 介绍 了 Android 对 于 耗 时 操作 线程 与 UI 主线 程 更 新 。 我 们 通过 实例 , 分 
别 使 用 Android 中 的 消息 循环 机 制 (Looper-Handler) 和 异步 任务 (AsyncTask) 来 实现 了 
耗 时 操作 和 UI 界面 的 交互 。 当 使 用 消息 循环 机 制 时 ， 我 们 需要 新 建 线程 、 自 定义 发 送 的 
信息 以 及 自 定义 对 不 同 消息 的 处 理 ， 而 当 使 用 异步 任务 时 ， 我 们 只 需要 实现 异步 任务 中 的 
4 个 步骤 即 可 。 但 是 , 异步 任务 本 质 上 也 是 使 用 Android 消息 循环 机 制 , 是 对 线程 和 Handler 
进行 了 封装 以 方便 使 用 。 
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3.5 本 章 总 -器 











本 章 介 绍 了 Android 应 用 程序 中 的 Activity、Service、BroadcastReceiver 三 大 组 件 、 组 
件 间 的 “信使 ”Intent 以 及 Android 中 的 消息 循环 机 制 。 通 过 实例 讲解 了 三 大 组 件 的 使 用 ， 
分 析 了 各 自 的 生命 周期 \、 常 用 的 情况 。 并且 通 过 工作 线程 和 UI 线程 的 更 新 , 讲解 了 Android 
中 的 消息 循环 机 制 。 这 些 组 件 作 为 Android 应 用 程序 中 的 基础 ， 在 开发 应 用 程序 中 是 必 不 
可 少 的 组 件 ， 消 息 循环 机 制作 为 处 理应 用 程序 的 多 线程 通信 ， 是 必 不 可 少 的 机 制 。 这 些 都 
是 本 章 的 重点 也 是 难点 ， 并 且 是 实际 开发 中 必须 熟练 使 用 的 技能 。 








3.6 习 题 


【习题 1】 参 照 3.1.2 小 节 拨 打 电 话 的 内 容 ， 实 现 发 送 邮件 的 跳 转 。 
外 提示 : 发 送 邮件 和 拨打 电话 的 主要 区 别 是 两 者 的 动作 不 同 ， 传 递 的 数据 参数 不 同 。 
关键 代码 : 


Intent data=new Intent (Intent.ACTION SENDTO); 
data.setData (Uri.parse ("mailto:qql0000@qq.com")); 
data.putExtra (Intent .EXTRA SUBJECT，" 这 是 标题 "); 
data.putExtra(Intent .EXTRA TEXT,， "这 是 内 容 "); 


【习题 2】 结合 3.2 与 3.3 节 中 的 系统 广播 和 服务 的 内 容 ， 实 现 开 机 启动 服务 。 


名 提示: 在 Android 系统 完全 启动 后 ， 会 发 送 一 个 广播 。 在 该 广播 的 接收 处 理 中 实现 启动 
服务 。 


关键 代码 ， 在 AndroidManifastxml 中 添加 权限 并 注册 一 个 广播 接收 : 


<uses-permission android:name="android.permission.RECEIVE BOOT COMPLETED"> 
</uses-permission> 
<receiver android:name=".ServiceBootReceiver"> 
<intent-filter> 
<action android:name="android.intent.action.BOOT COMPLETED" /> 
</intent-filter> 
</receiver> 


在 广播 接收 者 中 启动 服务 : 


public class ServiceBootReceiver extends BroadcastReceiver { 
static final String ACTION = "android.intent.action.BOOT COMPLETED"; 


@Override 
public void onReceive (Context arg0, Intent argl) { 
// TODO Auto-generated method stub 
if (argl.getAction() -equals (ACTION)) { 
// service 


i 
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【习题 3】 结 合 3.4 节 中 异步 消息 处 理 的 内 容 ， 使 用 手动 消息 循环 实现 异步 搜索 SD 卡 
文件 。 
名 提示: 在 3.4.2 中 使 用 了 异步 任务 ( AsyncTask ) 来 实现 搜索 SD 卡 文件 。 异步 任务 是 一 
个 有 系统 封装 的 消息 循环 ， 通 过 发 送 、 处 理 消息 来 实现 这 一 效果 。 


关键 代码 ; 
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Android 系统 能 够 在 全 球 引起 亿 万 用 户 的 推 尝 ， 与 其 良好 的 与 用 户 体验 密 不 可 分 。 前 
面 一 章 ， 我 们 学 习 了 Android 应 用 中 必 不 可 少 的 交互 界面 。 但 是 ， 只 拥有 了 一 个 这 样 的 友 
好 的 交互 界面 是 远 远 不 够 的 ， 我 们 还 得 将 用 户 的 常用 设置 、 音 频 文 件 、 视 频 文件 等 保存 起 
来 。 这 时 候 就 需要 使 用 到 Android 提供 的 数据 存储 。 


4.1 数据 存储 的 方式 


Android 中 一 共 提 供 了 以 下 4 种 数据 存储 方式 : 
口 SharedPreference: 该 存储 方式 适用 于 简单 数据 的 保存 ， 如 配置 属性 、 保 存 用 户 名 
等 具有 配置 性 质 的 数据 保存 ， 但 是 不 适合 数据 比较 大 的 保存 方式 。 
口 文件 存储 〈File) : 文件 存储 方式 是 较 常 使 用 的 一 种 保存 数据 方式 ， 可 以 保存 较 大 
的 数据 。 而 且 文 件 存储 不 仅 能 把 数据 存储 在 系统 中 也 能 将 数据 保存 到 SD 卡 中 。 
口 数据 库存 储 (SQLite) : Android 系统 提供 了 SQLite 标准 的 数据 库 ， 完 全 支持 SQL 
语句 。 同 样 地 ， 它 可 以 保存 较 大 数据 ,并 且 可 以 保存 在 系统 中 也 可 以 保存 在 SD 卡 
中 。 数 据 库存 储 可 以 保存 具有 一 定 规范 的 数据 ， 非 常 高 效 ， 但 是 相应 需要 数据 库 
的 操作 规范 ， 相 对 前 两 个 较 复 杂 。 
口 网 络 存储 (NetWork) : 该 存储 方式 通过 网 络 来 获取 和 存储 数据 ， 需 要 与 Android 
网 络 数 据 包 打交道 ， 与 网 络 相 关 的 应 用 一 般 都 会 使 用 到 该 存储 方式 。 
当然 ， 在 Android 系统 中 ， 很 多 数据 并 非 只 提供 给 一 个 应 用 来 使 用 的 ， 为 了 减少 数据 
的 元 余 ， 达 到 多 应 用 对 数据 的 共享 ，Android 提供 了 Content Providers 来 实现 数据 共享 。 本 
章 将 针对 这 4 种 数据 存储 方式 以 及 数据 共享 来 进行 详细 的 讲解 。 


4.2 SharedPreference 


想 想 我 们 常用 的 Android 软件 ， 大 部 分 软件 在 使 用 的 时 候 ， 都 需要 用 户 输入 对 应 的 用 
户 名 和 密码 ， 如 QQ、 新 浪 微 博 、 米 聊 等 。 同 时 ， 它 们 为 了 方便 用 户 操作 ， 都 允许 用 户 将 
输入 的 用 户 名 和 密码 进行 保存 ， 这 样 下 一 次 再 进入 登录 页 面 ， 就 自动 显示 上 次 登录 的 用 户 
名 和 密码 ， 从 而 提高 用 户 的 体验 度 。 这 一 节 ， 我 们 也 将 实现 保存 设置 的 功能 。 





4.2.1 自动 保存 登录 信息 


实际 上 , 自动 保存 登录 信息 功能 主要 是 利用 SharedPreferences 来 完成 的 。 正 如 本 章 4.1 
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节 提 到 的 那样 ，SharedPreferences 是 Android 系统 提供 的 一 个 轻 量 级 的 存储 类 ， 主 要 是 用 
于 保存 一 些 常 用 的 配置 性 的 数据 ， 如 用 户 名 及 密码 的 保存 、 登 录 方 式 的 保存 等 。 下 面 ， 就 
使 用 SharedPreferences 来 实现 这 样 的 功能 。 

1. 功能 说 明 

有 些 界面 需要 输入 账号 、 输 入 密码 和 是 否 记 住 密码 的 配置 选择 ， 如 图 4.1 所 示 。 相 信 
大 家 通过 上 一 章 的 实践 ， 对 实现 这 样 的 界面 应 该 比较 容易 。 

对 于 这 样 一 个 自动 保存 登录 信息 的 界面 ， 在 初始 化 时 ， 根 据 是 否 记 录 密 码 来 区 别 输入 
框 的 不 同 显示 。 当 不 记 住 密码 时 ， 账 号 、 密 码 输入 框 都 显示 空白 ， 并 不 勾 选 “ 记 住 密码 ” 
选项 ， 如 图 4.1 所 示 ; 当 记 住 密码 时 ， 账 号 、 密 码 输入 框 显 示 记 录 的 内 容 ， 并 勾 选 “ 记 住 
密码 ”选项 。 在 登录 时 ， 如 果 选 择 “ 记 住 密码 ”， 则 保存 账号 、 密 码 ， 供 下 次 使 用 ， 如 图 
4.2 所 示 ， 和 否则 不 保存 。 








1234567 


记 住 密码 图 


登录 成 功 ! 





图 4.1 不 记 住 密码 界面 图 4.2 记 住 密码 界面 


SharedPreferences 对 象 





2. 功能 实现 核心 
为 了 实现 如 上 的 功能 ， 需 要 SharedPreferences 对 象 的 配置 文件 来 保存 账号 、 密 码 以 及 
勾 选 状态 。 当 初始 化 界面 时 ， 读 取 配 置 文件 获取 信息 。 当 登录 时 ， 将 信息 保存 到 配置 文件 ， 
以 供 下 次 使 用 。 要 使 用 SharedPreferences， 必 须 创 建 获取 一 个 SharedPreferences 对 象 。 其 
使 用 到 的 方法 如 下 : 
getSharedPreferences (String name, int mode) 
其 中 ， 第 一 个 参数 是 文件 名 称 ， 第 二 个 参数 是 操作 模式 。 操 作 模式 一 共有 3 种 : 
口 ContextMODE _ PRIVATE: 值 为 0， 私有 模式 ， 新 内 容 履 盖 原 内 容 ; 
口 ContextMODE WORLD READABLE: 值 为 1， 人 允许 其 他 应 用 程序 读 取 ; 
口 ContextMODE WORLD WRITEABLE: 值 为 2， 人 允许 其 他 应 用 程序 写 入 ,会 覆盖 
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本 示例 中 ， 创 建 了 一 个 名 为 ex_data、 操 作 模 式 为 私有 模式 的 对 象 ， 代 码 如 下 : 


01 private SharedPreferences sp; 
02 sp = getSharedPreferences ("ex data", MODE PRIVATE); 


3. 读 取 数据 


在 读 取 数 据 时 ， 只 需要 对 SharedPreferences 文件 直接 读 取 即 可 。 例 如 ， 获 取 String 类 
型 的 数据 ， 就 使 用 如 下 方法 : 


getString (String key, String defValue) 


其 中 ， 第 一 个 参数 是 键 的 名 称 ， 第 二 个 参数 是 当 没 有 找到 对 应 的 第 一 个 参数 (key) 时 
返回 的 值 。SharedPreferences 也 提供 了 getBoolean、getInt、getLong 等 方法 来 获取 其 他 基本 
类 型 的 数据 。 

熟悉 了 读 取 数据 的 过 程 ， 就 可 以 在 界面 初始 化 时 ， 完 成 需要 的 功能 ， 代 码 如 下 : 

01 private boolean is check=true; 

02 is check = sp.getBoolean("save", true); 


03 ”// 读 取 上 次 登录 时 是 否 选 择 了 " 记 住 密码 "。 如 果 找到 了 save 的 值 ， 便 返回 save 的 值 ; 如 
04 果 没 有 找到 save 的 值 ， 就 返回 第 二 个 参数 true 





05 LE (L153 checky Ff 

06 cbx save.setChecked (true); // 勾 选 选择 框 
07 // 选 择 保存 ， 则 取出 数据 

08 String name = sp.getString("login", "");  // 获 取 登 录 名 
09 String psw = sp.getString("password"，"") ; // 获 取 密 码 
0 et login.setText (name); // 显 示 登 录 名 
ll et password.setText (psw); // 显 示 密 码 
le lelse { 

13 cbx_save.setChecked (false); // 不 勾 选 选择 框 
14 et login.setText(""); 

5 et password.setTag(""); 

16 } 


其 中 , 01 一 04 行 , 初始 化 界面 时 ， 首先 从 SharedPreferences 文件 中 读 取 save 对 应 的 布 
尔 值 ， 该 值 用 于 判断 是 否 选择 了 “ 记 住 密码 ”; 

05 一 11 行 ， 如 果 值 为 “ 真 ”， 则 表明 选择 “ 记 住 密码 ”， 勾 选 “ 记 住 密码 ”选项 ， 并 
读 取 出 登录 名 、 密 码 信 息 ， 分 别 显示 在 账号 输入 框 和 密码 输入 框 中 ; 

12 一 16 行 ， 如 果 值 为 “ 假 ”， 则 表明 未 选择 “ 记 住 密码 ”， 不 勾 选 “ 记 住 密码 ”时 ， 
账号 和 密码 输入 框 显示 为 空白 。 

4. 保存 数据 


要 修改 SharedPreferences 对 象 文件 ， 需 要 3 个 步骤 : 
(1) 需要 对 象 文 件 在 可 编辑 状态 Editor 下 。 获 取 编 辑 权 限 ， 使 用 的 方法 : 


edit() 


该 方法 返回 一 个 SharedPreferences.Editor 类 对 象 ， 从 而 使 用 Editor 类 对 象 来 修改 数据 。 
(2) 使 用 Editor 修改 数据 。 其 针对 不 同 的 数据 类 型 ， 提 供 了 不 同 的 修改 数据 的 方法 ， 
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如 对 String 类 型 的 修改 : 


PutString(String key, String value) 


其 中 ， 第 一 个 参数 是 键 的 名 称 ， 第 二 个 参数 是 该 键 的 值 。Editor 还 提供 了 putBoolean、 
putInt、putLong 等 方法 来 保存 其 他 基本 类 型 的 数据 。 

(3) 当 完 成 数据 修改 后 ， 需 要 提交 才能 保存 对 数据 的 修改 ， 否 则 修改 是 无 效 的 。 提 交 
的 方法 : 


commit() 


熟悉 了 保存 数据 的 整个 过 程 ， 就 可 以 实现 登录 时 的 功能 。 登 录 时 ， 当 选择 了 “ 记 住 密 
码 ” 选 项 ， 则 需要 保存 输入 的 内 容 。 先 获取 可 编辑 对 象 Editor， 然 后 修改 账号 、 密 码 为 输 
入 框 中 的 内 容 ， 最 后 提交 保存 修改 。 当 未 选择 “ 记 住 密码 ”选项 时 ， 需 要 将 已 保存 的 内 容 
修改 为 空 值 。 代 码 如 下 : 


01 if (cbx save.isChecked()) { 
02 // 保 存 数据 
03 Editor editor =sp.edit(); // 获 取 编 辑 对 象 
04 editor.putSstring ("login",et login.getText() .toString()) 7 
// 修 改 登录 名 
05 editor.PutString("Password"， et _pPassword.getText() .上 toString()) 
// 修 改 密码 
06 editor.putBoolean("save", true); // 修 改 是 否 勾 选 
07 editor.commit(); // 提 交 保 存 修改 
08 // 从 sp.edit () 开始 进入 编辑 状态 ， 直 到 commit () 提交! 
09 Toast .makeText (context， "登录 成 功 !"“，1000) .show() 
10 lelse { 
LL sp-.edit() .putSstring ("login”, "") 
12 .putstring ("password", "") 
3 .putBoolean ("save", false) 
14 .commit (); 
U5 // 使 用 较 简 洁 的 方式 ， 完 成 保存 数据 的 功能 
16 Toast .makeText (context， "登录 成 功 !"，1000) .show() 
Eh } 
其 中 ，01 一 03 行 ， 当 “ 记 住 密码 ”选项 被 勾 选 时 ， 获 取 可 编辑 的 SharedPreferences 对 
象 文 件 ; 


04 一 06 行 ， 修 改 文件 中 账号 、 密 码 内 容 以 及 色 选 状态 的 对 应 值 ， 将 值 分 别 修改 为 输入 
的 账号 、 密 码 以 及 “ 记 住 密码 ”选项 的 勾 选 状态 ; 

07 一 10 行 ， 对 文件 修改 进行 提交 ， 提 交 成 功 才 完成 了 SharedPreferences 的 修改 。 保 存 
信息 后 ， 提 示 登 录 成 功 ; 

11 一 14 行 ， 对 文件 的 修改 提交 过 程 更 加 简洁 的 实现 。 

5. 运行 分 析 

对 程序 运行 调试 ， 实 现 了 对 账号 、 密 码 这 样 的 少量 数据 以 及 是 否 记 住 密码 这 样 的 配置 
信息 的 保存 ， 对 用 户 更 加 的 友好 了 。 作 为 开发 者 ， 我 们 在 知道 了 SharedPreferences 的 读 取 
和 写 入 数据 的 实现 后 ， 来 看 看 SharedPreferences 到 底 在 Android 系统 中 以 何 种 方法 进行 保 
存 的 。 
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(1) 找到 保存 的 位 置 ， 在 /data/data/PACKAGE NAME/shared prefs 目录 下 。 在 Eclipse 
中 切换 到 DDMS 视图 ,选择 File Explorer 标签 。 打 开 目 录 ， 就 找到 了 用 来 保存 数据 的 文件 
ex_dataxml， 如 图 4.3 所 示 。 





















PP 辐 | 需 Dms | 高 :Tevs 
DS nee [Bo [oni ve “ 
匣 本 | 一 
| Jane Size Date Tine EF 
| BE com. android tern 2010-10-10 17:00 由 
图 区 con. sndroid wallpaper. livel 2010-10-10 17:00 由 

ES com leno. ex_data 2011-08-07 22:28 6 

9 SBDlib 2011-08-07 22:20 由 
则 SB shared prefs 2011-08-07 22:28 由 
] 局 ex_data xm] 148 2011-08-07 22:28 一 
引 由 GB com svox. pico 2010-10-10 17:00 由 
ji EG jp. co. omronsoft openwnn 2010-10-11 19:52 由 
1 HG dontpanic 2010-10-10 16:53 由 
一 蕊 leea 2010-10-10 16:53 由 

EB losttfomd 2010-10-10 16:53 由 
De onin-in-in Misa 和 





图 4.3 ”SharedPreferences 存储 目录 


(2) 导出 ex_data.xml 文件 ， 我 们 看 到 文件 内 容 如 下 : 

<?xml version='1.0' encoding='utf-8' standalone='yes' ?> 

<map> 

<boolean name="save" Value="true" /> 

<string name="password">1234567</string> 

<string name="login">ouling</string> 

</map> 

不 难看 出 , SharedPreferences 采用 标准 XML 文件 的 形式 ,通过 保存 键 值 对 来 存储 数据 。 
在 对 XML 文件 处 理 时 ，Dalvik 虚拟 机 会 通过 自 带 底层 的 本 地 XML Parser 进行 解析 ， 这 样 
虽然 效率 不 是 特别 高 ， 但 是 由 于 数据 量 不 大 ， 影 响 较 小 ， 而 且 对 内 存 资 源 的 占用 也 是 比较 
好 的 。 


4.2.2 多 应 用 程序 共享 用 户 信息 


由 于 Android 的 安全 机 制 ， 各 个 应 用 程序 之 问 的 私有 数据 进行 了 严格 的 隔离 ， 一 般 是 
无 法 进行 访问 的 。 但 是 当 不 同 应 用 程序 之 间 需 要 共享 用 户 信息 时 ， 如 何 来 实现 呢 ? 
SharedPreferences 就 是 用 来 保存 一 个 apk( 应 用 程序 ) 的 私有 信息 和 配置 信息 等 少量 数据 的 ， 
可 以 共享 SharedPreferences 来 实现 多 应 用 程序 共享 用 户 信息 。 

接 下 来 ， 新 建 一 个 应 用 程序 来 获取 上 一 小 节 中 保存 的 用 户 信息 。 


1. 设置 SharedPreferences 访 问 模式 





前 面 我 们 讲 到 创建 SharedPreferences 时 ， 可 以 知道 其 有 3 种 不 同 的 操作 模式 。 如 果 允 
许 其 他 应 用 程序 访问 本 应 用 程序 中 的 SharedPreferences 。 其 前 提 条 件 就 是 ， 在 该 
SharedPreferences 创建 时 ， 指 定 其 操作 模式 为 Context.MODE_WORLD READABLE 或 者 
ContextMODE WORLD WRITEABLE 权限 。 以 上 一 小 节 示 例 为 例 ， 创 建 一 个 允许 其 他 应 
用 读 取 的 SharedPreferences， 则 代码 可 修改 如 下 : 
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sp = getSharedPreferences ("ex data", MODE _ WORLD READABLE); 


2. 访问 SharedPreferences 


其 他 应 用 程序 访问 该 SharedPreferences， 需 要 获得 SharedPreferences 所 在 包 的 上 下 文 
环境 Context， 才 能 读 取 数 据 。 方 法 如 下 : 

createPackageContext (String packageName, int flags) 

其 中 ， 第 一 个 参数 为 包 的 名 称 ， 该 名 称 是 一 个 唯一 完整 的 包 名 ; 第 二 个 参数 是 使 用 的 
方式 。 这 样 就 可 以 读 取 该 SharedPreferences 对 象 文件 ， 实 现 多 应 用 程序 共享 用 户 信息 了 。 
例如 ， 获 取 上 一 小 节 中 保存 的 用 户 信 息 ， 效 果 如 图 4.4 所 示 。 








ex apk share 





图 4.4 共享 用 户 信息 


具体 代码 如 下 : 


01 Context other apps context = null; // 定 义 context 
02 Ew 
03 other apps context = createPackageContext ("com.leno. 
ex data", 0); //com.leno.ex data 包 的 上 下 文 环境 Context 
04 } catch (NameNotFoundException e) { 
05 System.out .println(e.toString()) 7 // 输 出 异常 
06 } 
07 SharedPreferences other app sp = other apps context. 
getSharedPreferences ( 
08 "ex data", Context.MODE PRIVATE); 
// 获 取 SharedPreferences 对 象 
09 String text= other app sp.getAll() .tostring(); 


// 获 取 SharedPreferences 的 内 容 


其 中 ，01 一 06 行 ， 以 默认 方式 获取 com.leno.ex_data 包 的 Context， 当 没有 权限 或 者 其 
他 原因 产生 异常 时 打印 异常 信息 ; 

07 一 08 行 ， 以 私有 模式 获取 com.leno.ex_data 包 中 名 为 ex_data 的 SharedPreferences 
对 象 ; 

09 行 ， 获 取 SharedPreferences 的 内 容 。 


43 文件 存储 


翻 看 Android 设备 的 数据 ， 就 会 发 现 各 式 各 样 的 文件 ， 如 文本 文件 、pdf 文件 、 图 片 文 
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件 、 音 视频 文件 等 等 ， 文 件 存储 占据 了 Android 设备 中 最 多 的 一 部 分 。 文 件 的 保存 和 读 取 
操作 也 是 Android 程序 中 最 常 使 用 的 功能 ， 无 论 是 网 络 下 载 歌 曲 还 是 阅读 手机 上 的 小 说 、 
拍摄 照片 还 是 播放 视频 ， 都 会 使 用 到 文件 的 保存 和 读 取 。 这 一 节 ， 我 们 将 实现 对 文件 的 保 
存 与 读 取 。 

4.3.1 文件 的 保存 和 读 取 


Android 系统 是 支持 标准 Java 的 IO 操作 的 , 同时 也 提供 了 简化 读 写 流 式 文 件 过 程 的 函 
数 。 下 面 通 过 对 文本 文件 的 操作 示例 ， 来 学 习 文 件 的 保存 与 读 取 。 


1. 功能 说 明 


在 界面 需要 提供 保存 到 文件 的 文本 输入 框 、 显 示 文 件 内 容 的 输入 框 ， 以 及 分 别 进行 保 
存 文本 、 读 取 文 本 的 按钮 ， 实 现 效果 如 图 4.5 和 图 4.6 所 示 。 


文本 保存 测试 


文本 保存 测试 


保存 文件 成 功 获取 文本 成 功 ! 





图 4.5 保存 文件 图 4.6 读 取 文 件 


对 于 如 上 的 文件 保存 与 读 取 界面 ， 分 别 给 每 个 按钮 添加 单 击 监听 事件 。 当 输入 不 为 空 
时 ， 则 单 击 “ 保 存 文本 ”按钮 实现 文本 文件 保存 到 应 用 程序 目录 下 。 通 过 单 击 “ 读 取 文 件 ” 
按钮 实现 对 应 用 程序 目录 下 的 文件 读 取 。 


2. 保存 文件 











Android 由 于 支持 标准 的 Java 的 IO 操作 ， 所 以 只 需要 获取 了 Java 标准 的 文件 输出 流 
(FileOutputStream) 和 文件 输入 流 (FileImmputStream) ， 就 能 够 以 标准 Java 方式 来 操作 文件 
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(1) Android 中 的 Context 提供 了 openFileOutput0 方 法 可 以 获取 Java 标准 文件 输入 流 


FileOutputStream。 该 方法 为 写 入 数据 做 准备 而 打开 应 用 程序 私有 文件 。 若 不 存在 ， 则 在 应 


用 程 


流 ， 


序 目 录 下 创建 一 个 文件 。 


openFileOutput (String name, int mode) 


其 中 ， 第 一 个 参数 是 文件 名 称 ， 第 二 个 参数 是 操作 模式 。 操 作 模式 一 共有 4 种 。 
口 ContextMODE PRIVATE: 值 为 0， 私有 模式 ， 也 是 默认 的 操作 模式 。 新 内 容 将 履 
盖 原 内 容 。 
口 Context.MODE APPEND: 值 为 32768， 追 加 模式 。 新 内 容 将 追加 到 原文 件 后 面 。 
口 ContextMODE WORLD READABLE: 值 为 1， 人 允许 其 他 应 用 程序 读 取 。 
口 ContextMODE WORLD WRITEABLE: 值 为 2， 允 许 其 他 应 用 程序 写 入 ， 会 覆盖 
本 示例 中 ， 创 建 了 一 个 名 为 ex_file.txt 的 文本 文件 、 操 作 模 式 为 私有 模式 的 文件 输出 
代码 如 下 : 
01 FileOutputSstream fos; 
02 fos = openFileOutput (FILENAME, Context.MODE PRIVATE); 

// 以 私有 模式 创建 文件 
(2) 得 到 了 文件 输出 流 FileOutputStream 后 ， 就 和 Java 保存 数据 到 文件 中 是 一 样 的 。 
熟悉 了 文件 保存 的 整个 过 程 ， 就 可 以 将 文件 保存 到 程序 目录 下 ， 实 现代 码 如 下 : 





01 private String FILENAME = "ex file.txt";  // 定 义 文件 名 
02 FileOutputStream fos; // 定 义 文件 输出 流 
03 try { 
04 fos = openFileOutput (FILENAME, Context.MODE PRIVATE); 
// 以 私有 模式 创建 文件 
D5 String text = et input.getText() .toSstring(); 
// 获 取 输 入 框 的 输入 内 容 
06 fos .write (text.getBytes()) ; // 写 入 数据 
07 fos.flush(); 
08 fos.close(); // 关 闭 FileoutputStream 
09 Toast.makeText (context， "保存 文件 成 功 "，1000) .show() 
10 } catch (FileNotFoundException e) { 
汪汪 e.printstackTrace () 7 
2 } catch (IOException e) { 
3 e.printSstackTrace (); 
14 } finally { 
15 // 在 finally 中 关闭 流 ! 因 为 如 果 找 不 到 数据 就 会 异常 ， 我 们 也 需要 对 其 进行 
关闭 操作 
16 Erwm 
ky if (fos!= null) { 
18 // 这 里 也 要 判断 ， 因 为 找 不 到 的 情况 下 ， 两 种 流 也 不 会 实例 化 
19 / /既然 没 有 实例 化 ， 还 去 调用 close 关闭 它 ， 肯 定 “ 空 指针 ”异常 
20 fos.close(); 
2 让 
22 } catch (IOException e) { 
23 e.printstackTrace (); 
24 和 
Pd } 


其 中 ，01 一 04 行 ， 创 建 名 为 ex_file.txt 的 私有 模式 下 的 文件 输出 流 ; 
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05 一 09 行 ， 获 得 输入 框 中 的 内 容 ， 并 将 内 容 写 入 文件 ， 完 成 后 关闭 文件 输出 流 并 提示 
“保存 文件 成 功 ”; 

10 一 14 行 ， 当 文件 没有 创建 、 写 入 出 错时 ， 捕 获 到 异常 则 相应 地 处 理 异 常 。 在 对 文件 
进行 操作 时 ， 异 常 处 理 是 必要 的 ， 否 则 整个 程序 极 易 崩溃 ， 

15 一 25 行 ,关闭 文件 输出 流 。 由 于 可 能 发 生 异 常 后 ,文件 输出 流 没有 关闭 ,所 以 在 finally 
中 关闭 输出 流 。 当 然 ， 对 文件 输出 流 也 是 需要 异常 保护 的 。 运 行 结果 如 图 4.5 所 示 。 

3. 读 取 文件 


保存 文件 时 ， 使 用 文件 输出 流 。 相 应 地 ， 在 读 取 文件 时 ， 使 用 Java 标准 的 文件 输入 流 
FileInputStream 来 对 文件 进行 读 取 。 获 取 FileInputStream 的 方法 : 


openFileInput (String name) 


它 为 读 取 数 据 做 准备 而 打开 应 用 程序 的 私有 文件 。 其 中 ， 参 数 为 文件 的 名 称 。 如 果 获 
取 成 功 ， 则 返回 FileImputStream。 和 否则 ， 抛 出 FileNotFoundException 的 异常 。 获 得 
FileInputStream 后 ， 读 取 文 件 的 方法 和 Java 中 读 取 文件 的 方法 是 一 样 的 。 

熟悉 了 读 取 文件 的 过 程 ， 下 面 ， 读 取 上 小 节 中 保存 在 应 用 程序 目录 下 的 名 为 ex_file.txt 
文件 的 内 容 。 具 体 实现 如 下 : 














01 Cey 
02 FileInputStream inStream = null; // 定 义 文件 输入 流 
03 inStream = openFileInput (FILENRME) ; // 获 取 指 定 文件 的 输入 流 
04 ByteArrayOutputStream stream = new ByteArrayOutputStream(); 
// 实 例 化 字 节 输出 流 
05 byte[] buffer = new byte[1024]; // 输 入 输出 缓存 
06 int length = -1; 
07 while ((length = inStream.read(buffer)) != -1) { 
// 读 取 文 件 输入 流 的 内 容 到 缓存 中 
08 stream.write (buffer，0，1length) ; ”// 将 缓存 写 入 输入 流 中 
09 } 
10 stream.close(); // 关 闭 输 出 流 
Em inStream.close(); // 关 闭 文 件 输入 流 
站 人 et_output .setText (stream.toString()) 7 
// 设 置 输入 框 内 容 为 输入 流 的 文字 
13 Toast .makeText (context， "获取 文本 成 功 !"，1000) .show() 
14 } catch (FileNotFoundException e) { 
5 e.printSstackTrace (); 
16 Toast .makeText (Context， "文件 未 找到 "，1000) .show (); 
// 打 印 异 常 信息 
17 } catch (IOException e) { 
18 e.printSstackTrace (); 
19 } finally { // 无 论 是 否 异常 都 需要 关闭 输入 输出 流 
20 Ey 
2 if (stream != null) // 输 出 流 不 为 定 ， 则 关闭 输出 流 
史 妆 stream.close(); 
2 if (inStream != null) // 输 入 流 不 为 空 ， 则 关闭 输入 流 
24 inStream-close () 7 
25 } catch (IOException e) { 
26 e.printSstackTrace (); 
Et } 
28 
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其 中 ，01 一 03 行 ， 获 取 对 文件 名 为 ex_file.txt 的 文件 的 文件 输入 流 ， 用 于 读 取 文 件 ; 

04 一 11 行 , 为 了 防止 读 取 大 型 文件 导致 的 内 存 不 足 ， 所 以 每 次 读 取 的 数据 量 一 定 要 将 
FilemputStream 中 的 数据 读 入 缓冲 区 buffer 中 ， 再 把 buffer 中 的 数据 写 入 stream 中 。 读 取 
完成 后 ， 关 闭 数 据 流 ; 

12 一 28 行 ， 将 读 取 的 数据 显示 在 输入 框 中 ， 并 对 相应 的 异常 进行 处 理 ， 运 行 结果 如 图 
4.6 所 示 。 


4.3.2 ”SD 卡 文件 的 保存 和 读 取 


上 面 实现 了 对 程序 目录 下 文件 的 保存 和 读 取 , 但 是 Android 自身 的 存储 空间 是 有 限 的 ， 
常常 不 能 满足 我 们 的 需要 。 所 以 ， 会 经 常 使 用 到 外 部 的 存储 设备 ， 如 SD 卡 。 

由 于 Android 本 身 的 安全 机 制 的 原因 ， 在 保存 和 读 取 外 部 文件 时 有 更 加 严格 的 限制 ， 
所 以 操作 SD 卡 文件 和 程序 私有 文件 有 一 定 的 区 别 。 


1. 功能 说 明 


在 上 一 小 节 的 界面 中 ， 添 加 “保存 到 SD 卡 ”、“ 读 取 SD 卡 文本 ”按钮 ， 用 于 实现 
SD 卡 文件 的 保 在 和 读 取 ， 实 现 效果 如 图 4.7 和 图 4.8 所 示 。 


ex file 


文本 保存 到 sd 卡 测试 


文本 保存 到 sd 卡 测试 


读 取 文 本 用 读 取 SD 卡 文本 读 取 文本 晶 读 取 SD 卡 文本 


保存 文件 到 sd 卡 成 功 获取 文本 成 功 ! 





图 4.7 保存 SD 卡 文件 图 4.8 读 取 SD 卡 文件 


2. 保存 文件 到 SD 卡 


将 文件 保存 到 SD 卡 上 ,和 保存 到 系统 空间 一 样 ,都 是 通过 文件 输出 流 FileOutputStream 
来 写 入 文件 。 但 是 在 获取 FileOutputStream 时 ， 需 要 的 权限 和 实现 方式 是 不 一 样 的 。 


"1s 
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(1) 获取 访问 SD 卡 的 权限 
程序 对 SD 卡 的 文件 数据 进行 读 取 、 写 入 、 删 除 等 操作 ， 必 须 申请 访问 SD 卡 的 权限 。 
在 AndroidManifest.xml 中 加 入 访问 SD 卡 的 权限 ， 代 码 如 下 : 


01 
02 


03 
04 


<!-- 在 SD 卡 中 创建 与 删除 文件 权限 --> 

<uses-permission android:name="android.permission.MOUNT UNMOUNT 
FILESYSTEMS" /> 

<!-- 往 SD 卡 写 入 数据 权限 --> 

<uses-permission android:name="android.permission.WRITE EXTERNAL 
STORAGE"/> 


(2) 判断 SD 卡 状态 
在 访问 SD 卡 数据 前 ， 需 要 判断 SD 卡 的 状态 ， 查 看 SD 卡 设备 是 否 准备 就 绪 、 是 否 可 
以 读 写 等 。 使 用 Environment 类 来 访问 环境 变量 ， 使 用 的 方法 : 


String getExternalStorageState () 


OOOOOOOO 这 


口 


回 设备 状态 ， 一 共有 9 种 不 同 的 状态 ， 分 别 是 : 


MEDIA_BAD REMOVAL: 表明 SD 卡 被 卸载 前 已 被 移 除 。 

MEDIA_CHECKING: 表明 对 象 正在 磁盘 检查 。 

MEDIA_MOUNTED: 表明 对 象 存在 并 具有 读 / 写 权限 。 
MEDIA_MOUNTED_ READ ONLY: 表明 对 象 权 限 为 只 读 。 

MEDIA_NOFS: 表明 对 象 为 空白 或 正在 使 用 不 受 支持 的 文件 系统 。 
MEDIA_REMOVED: 表明 不 存在 。 

MEDIA_SHARED: 表明 SD 卡 未 安装 ， 并 通过 USB 大 容量 存储 设备 共享 。 
MEDIA_UNMOUNTABLE: 表明 SD 卡 不 可 被 安装 ， 即 使 SD 卡 存在 但 也 是 不 可 
以 被 安装 的 。 

MEDIA_UNMOUNTED: 表明 SD 卡 已 卸 掉 , 如 果 SD 卡 是 存在 的 , 则 没有 被 安装 。 





要 将 文件 保存 到 SD 卡 中 ，SD 卡 必 须 存 在 并 且 可 读 写 ， 即 MEDIA_MOUNTED 状态 。 
(3) 获取 文件 输出 流 
对 SD 卡 写 入 文件 时 ， 不 能 使 用 openFileOutput0 方 法 。 因 为 它 仅仅 能 写 入 应 用 程序 自 


有 目录 ， 


需要 使 用 标准 文件 输出 流 方法 : 


FileOutputSstream (File file, boolean append) 

其 中 ， 第 一 个 参数 是 写 入 数据 的 文件 类 ;第 二 个 参数 表明 是 否 以 追加 方式 添加 数据 ， 
若是 tue， 则 以 追加 方式 添加 数据 ， 和 否则 以 覆盖 方式 添加 数据 。 

熟悉 了 整个 文件 保存 到 SD 卡 的 过 程 ， 就 可 以 将 文件 保存 到 SD 卡 中 了 。 权 限 获 得 后 


的 保存 ， 


OL 
02 
03 


04 
05 
06 
07 


实现 代码 如 下 : 


private String FILENAME = "ex file.txt";  // 定 义 文件 名 
IE (Environment.getExternalStorageState() .equals( 


android.os.Environment.MEDIRA MOUNTED)) { 
// 判 断 SD 卡 是 否 准备 就 绪 
FileOutputStream ostream = null; // 定 义 文件 输出 流 


Ery et 
File myfile = new File(Environment 
-getExternalStorageDirectory () .getPath(), 


FILENAME) ; // 实 例 化 sD 卡 中 指定 路 径 的 文件 类 


Ws 
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08 if (!myfile-exists()) { // 该 路 径 中 文件 不 存在 则 创建 该 文件 
09 myfile.createNewFile(); 
10 } 
11 ostream = new FileOutputStream(myfile, true); 
// 获 取 该 文件 的 输出 流 
LE String text = et _input-getText() -toString() 
// 获 取 输 入 框 的 输入 文字 
13 ostream.write (text.getBytes ()); // 写 入 文件 输出 流 中 
14 ostream.close(); // 关 闭 文件 输出 流 
5 Toast .makeText (context, "保存 文件 到 sD 卡 成 功 "， 
1000) .show(); 
16 } catch (FileNotFoundException e) { 
7 e.printStackTrace (); 
18 } catch (IOException e) { 
19 e.printSstackTrace (); 
20 } finally { // 无 论 是 否 异 常 都 需要 关闭 输出 流 
之 兹 if (ostream != null) { 
这 brawl 
jc | ostream.close(); 
24 } catch (IOException e) { 
25 e.printStackTrace (); 
26 . 
En } 
28 } 
29 


其 中 ，01 一 03 行 ， 判 断 SD 卡 设备 的 状态 ， 当 SD 卡 存 在 并 可 以 读 写 才 进行 写 入 操作 ; 
04 一 10 行 , 在 SD 卡 目录 下 获得 一 个 文件 名 为 ex_file.txt 的 文件 对 象 myfile, 如 果 没 有 


则 创建 ， 该 文件 用 于 保存 数据 ; 
11 行 ， 创 建 一 个 文件 输出 流 ostream， 它 以 追加 方式 写 入 


myfile 对 象 ; 


12 一 15 行 , 通过 文件 输出 流 将 数据 写 入 文件 , 完成 后 关闭 文件 输出 流 并 提示 保存 成 功 ; 
16 一 29 行 , 文件 写 入 时 的 相关 异常 处 理 ， 原 理 同文 件 写 入 系统 ,运行 结果 如 图 4.7 所 示 。 


3. 读 取 SD 卡 文件 


读 取 SD 卡 中 文件 与 保存 SD 卡 文件 步骤 差不多 ， 但 是 读 取 SD 卡 文件 是 获取 


FileInputStream， 通 过 文件 输入 流 来 读 取 文件 。 


(1) 判断 SD 卡 状 态 。 与 写 入 SD 卡 时 的 判断 状态 的 方法 是 一 样 。 


(2) 获取 FileInputStream， 使 用 标准 文件 输入 流 方法 : 


FileInputSstream(File file) 


其 中 ,参数 是 读 取 数 据 的 文件 类 。 能 够 读 取 数据 ， 则 返回 





否则 返回 FileNotFoundException 异常 。 





文件 输入 流 FileInputStream， 


获取 文件 输入 流 后 读 取 文件 的 方法 和 读 取 程 序 目 录 下 的 方法 是 相同 的 .熟悉 了 读 取 SD 
卡 的 文件 过 程 后 ， 实 现 读 取 SD 卡 下 名 为 ex_file.txt 文件 的 内 容 。 代 码 如 下 : 


01 FileInputStream inStream = null; // 定 义 文件 输入 流 
02 if (Environment.getExternalStorageState() .equals ( 
03 android.os.Environment .MEDIA MOUNTED)) { 
// 判 断 SD 卡 是 否 准备 就 绪 
04 File sd file = new File(Environment 
05 .getExternalStorageDirectory () .getPath () ,FILENRME) : 


ws 
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// 实 例 化 sD 卡 中 指定 路 径 的 文件 类 
06 f° (sofile-exzists()) // 当 文件 不 存在 ， 则 给 出 提示 并 返回 
07 Toast .makeText (context， "未 找到 该 文件 "，1000) .show(); 
08 return; 
09 } 
10 inStream = new FileInputStream(sd file); 

// 获 取 SD 卡 中 的 文件 输入 流 
11 } 


其 中 ，01 一 03 行 ， 判 断 SD 卡 状态 ， 当 SD 卡 存在 并 可 以 读 写 才 进 行 读 取 操作 ; 

04 一 09 行 ， 获 取 SD 卡 目录 中 ， 名 为 ex_file.txt 文件 的 文件 处 理 类 sd_file。 如 果 该 文 
件 不 存在 则 提示 失败 并 返回 ; 

10 一 11 行 ， 对 sd_file 创建 FilemputStream， 用 于 读 取 文 件 。 获 得 了 FilemputStream 后 
读 取 的 操作 和 读 取 系统 文件 的 方法 是 相同 的 , 详 见 4.3.1 小 节 中 文件 读 取 的 代码 04 一 28 行 ， 
运行 结果 如 图 4.8 所 示 。 


4. 运行 分 析 总 结 





对 程序 进行 调试 运行 ,我们 实现 了 对 程序 目录 下 和 SD 卡 中 文件 的 保存 和 读 取 。 但是， 
文件 的 保存 位 置 是 否 分 别 在 程序 目录 下 和 SD 卡 中 呢 ? 下 面 ， 查 看 一 下 文件 位 置 。 

找到 程序 目录 保存 的 位 置 ， 在 /data/data/PACKAGE NAME/files 目录 下 。 在 Eclipse 中 
切换 到 DDMS 视图 ， 选 择 File Explorer 标签 。 打 开 目 录 ， 就 找到 了 用 来 保存 数据 的 文件 
ex_file.txt, 如 图 4.9 所 示 。 查看 SD 卡 中 的 文件 , 在 /mnt/sdcard/ex_file.txt 目录 下 , 如 图 4.10 
所 示 。 





和 Threads | 自 Heap Mlocation Tracker | 





Threads | 国 Heap | 国 局 location Tracker | 















Hame s 


由 > com. leno. ex_data Jane Size 


由 > com. ouling. ex_apk_share BD sdcard 

日 i i 由 区 LDST. IIR 

SB 世 com. ouling. ex_file = 
已 files 目 dqcx. lre 1241 
二 生生 是 aaex.mp3 5453080 


外 ex_file. txt 






全 ex_file. txt 





外包 lib 晤 leftisright.mp3 4264744 

由 CG com. svox. pico nissill. mp3 3047549 

由 CG jp. ceo. omronsoft. openwnn song. wna 2035935 
图 4.9 程序 目录 图 4.10 SD 卡 目录 


4.3.3 文件 存储 总 结 


完成 了 对 程序 目录 下 和 SD 卡 目录 下 的 文件 的 保存 和 读 取 操作 ， 发 现 最 终 都 是 使 用 标 
准 的 Java 文件 处 理 ， 用 文件 输出 流 FileOutputStream 和 文件 输入 流 FileInputStream 来 对 文 
件 进行 读 取 和 写 入 。 

对 程序 目录 下 的 文件 ， 不 需要 额外 的 权限 和 检测 ， 直 接 使 用 Android 提供 的 
openFileOutputO 和 openFileImput0 来 获取 文件 输出 流 FileOutputStream 和 文件 输入 流 
FileInputStream。 





了 生生 
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对 SD 卡 中 的 文件 ， 由 于 Android 的 安全 机 制 ， 需 要 申请 访问 SD 卡 的 权限 ; 然后 通过 
SD 卡 的 状态 ， 来 判断 是 否 可 以 保存 、 读 取 SD 卡 文件 。 最 后 使 用 标准 的 文件 输入 /输出 流 
获取 方法 FileOutputStream() 和 FileInputStream() 得 到 输入 /输出 流 。 














4.3.4 文件 复制 到 SD 卡 


通过 以 上 对 程序 目录 下 和 SD 卡 目录 下 的 文件 的 保存 和 读 取 操 作 , 我 们 已 经 对 Android 
的 文件 存储 有 了 直观 的 了 解 和 掌握 。 下 面 综合 使 用 对 不 同 目录 下 的 文件 操作 ， 来 实现 将 程 
序 目录 中 的 文件 复制 到 SD 卡 中 。 

1. 功能 说 明 

在 已 经 实现 的 界面 的 基础 上 进行 修改 , 添加 一 个 下 拉 列 表 和 一 个 “确定 复制 ”的 按钮 ， 
如 图 4.11 所 示 。 其 中 ， 下 拉 列 表 中 显示 程序 目录 中 的 所 有 文件 名 ， 用 于 用 户 选择 需要 复制 
的 文件 。 按 钮 则 用 于 确定 复制 ， 实 现 对 所 选 文件 的 复制 ， 如 图 4.12 所 示 。 


国有 EPE mr 


保存 文本 


ex_file.txt 


Justin Bieber-Baby.mp3 


完成 文件 复制 





图 4.11 完成 文件 复制 图 4.12 选择 复制 文件 


2. 获取 程序 目录 中 的 所 有 文件 


要 复制 程序 目录 下 的 文件 ， 首 先 需 要 知道 程序 目录 的 路 径 是 什么 ， 然 后 利用 File 类 的 
属性 ， 通 过 遍历 来 获取 路 径 下 所 有 的 文件 。 
对 于 知道 包 名 的 程序 ， 通 常 其 存储 数据 的 路 径 为 data/data/ PACKAGE NAME。 并 且 
程序 在 保存 数据 时 ， 会 根据 文件 的 不 同类 型 自动 保存 在 不 同 的 文件 夹 下 。 一 般 的 文件 保存 
在 files 文件 夹 中 ， 数 据 库 文件 保存 在 database 文件 夹 中 ， 第 三 方 库 保存 在 lib 文件 夹 中 。 
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例如 , 图 4.9 的 程序 目录 下 有 files 和 lib 文件 夹 。 同时 Android 也 提供 了 获取 当前 目录 的 方 
法 ， 即 使 用 类 ContextWrapper 中 的 方法 : 


getFilesDir() 


该 方法 返回 的 类 型 是 File， 该 File 就 是 对 当前 运行 文件 夹 的 表示 。 通 过 File 就 可 以 获 








得 其 文件 名 、 完 整 路 径 、 上 层 文件 夹 、 是 否 为 文件 夹 ， 以 及 文件 夹 下 的 文件 数 等 信息 。 使 
用 到 File 的 方法 分 别 是 : 

getName () // 返 回 文件 或 文件 夹 名 称 ，String 类 型 

getPath () // 返 回 文件 或 文件 夹 完整 路 径 ，String 类 型 

getParentFile() // 返 回 其 父 文 件 ， 即 所 在 的 文件 夹 ，File 类 型 

isDirectory() // 返 回 该 文件 是 否 为 文件 夹 ，Boolean 类 型 

list() // 返 回 该 文件 目录 中 的 所 有 文件 名 ， 一 个 字符 串 数组 string[] 


熟悉 了 这 些 方法 , 就 可 以 实现 对 程序 目录 下 所 有 文件 的 获取 。 以 获得 com.ouling.ex_file 
旦 序 中 的 所 有 文件 为 例 ， 具 体 实现 代码 如 下 : 


01 


private static ArrayList<String> files; 

// 定 义 保存 文件 全 路 径 的 数组 
private static ArrayList<String> filenames; 

// 定 义 保存 文件 名 的 数组 
files = new ArrayList<String>(); 
filenames=new ArrayList<String>(); 
String path = getApplication() .getFilesDir() .getParentFile(). 
getPath () ; // 获 取 应 用 程序 的 文件 路 径 
getfiles (path); // 调 用 遍历 获取 文件 的 方法 


private void getfiles(String path) { 
File file = new File(path); // 实 例 化 指定 路 径 的 文件 类 
if (file.list() == null) { 
// 该 路 径 目 录 中 的 所 有 子 文件 或 子 文件 夹 是 否 为 空 
return; 
} 
int file num = file.1ist() .length; // 获 取 路 径 目 录 下 的 子 文件 数 
for (int i = 0; i < file num; i++) { 
// 遍 有 历 路 径 目 录 下 的 所 有 子 文件 
File child file = new File(pPath，file.list() [i]); 
// 获 取 子 文件 
if (chilqd file.isDirectory()){ // 如 果子 文件 为 文件 夹 
String child path = child file.getPath(); 
// 获 取 子 文件 夹 的 路 径 
getfiles (child path); // 遍 历 获取 子 文件 
} else if (child file.isFile()) {// 如 果子 文件 是 文件 
System.out.println (child file.getName()); 
files.add(child file.getPath()); 
// 将 文件 路 径 添加 到 文件 数组 中 
filenames.add(child file.getName()) : 
// 将 文件 名 添加 到 文件 名 数组 中 


} 


其 中 ，01 一 04 行 ， 定 义 和 初 始 化 files 数组 和 filenames 数组 。 这 两 个 String 数组 分 别 
用 来 保存 目录 下 文件 的 全 路 径 和 文件 的 名 称 ; 
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05 行 ， 获 得 程序 路 径 。 由 于 程序 在 保存 数据 时 ， 会 根据 文件 的 不 同类 型 自动 保存 在 不 
同 的 文件 夹 下 。 使 用 getApplication0.getFilesDirO 获 得 的 路 径 是 /PACKAGE NAME/files， 
其 父 文件 才 是 程序 所 在 的 路 径 ; 

06 行 ， 调 用 getfiles(path) 函 数 。 提 供 完整 路 径 ， 获 得 该 路 径 下 的 所 有 文件 ， 具 体 实现 
在 08 一 25 行 ; 

09 一 13 行 ， 判 断 该 路 径 文件 夹 下 是 否 还 有 文件 ， 如 果 没 有 文件 则 退出 函数 ， 有 文件 则 
获得 文件 个 数 ; 

14 一 15 行 ， 对 文件 夹 下 的 所 有 文件 分 别 获得 其 File; 

16 一 18 行 ， 当 File 为 文件 夹 时 ， 获 得 File 的 路 径 ， 调 用 getfiles(path) 进 行 递归 地 获取 
文件 夹 中 的 文件 ; 

19 一 23 行 ， 当 File 为 文件 时 ， 将 该 文件 全 路 径 保存 在 files 数组 中 ， 将 该 文件 名 保存 
在 filenames 数组 中 。 

3. 设置 下 拉 列表 

在 下 拉 列 表 中 ， 需 要 将 程序 目录 中 的 所 有 文件 名 进行 显示 ， 并 且 处 理 下 拉 列 表 的 选择 
事件 。 数 据 显示 需要 将 显示 的 数据 放 入 数据 适配器 〈ArrayAdapter) 中 ， 通 过 数据 适配器 
和 下 拉 列 表 的 连接 ， 从 下 拉 列 表 中 显示 ArrayAdapter 中 的 数据 。 

(1) ArrayAdapter 设置 

数据 导入 数据 适配器 使 用 ArayAdapter 的 构造 函数 来 实现 : 

ArrayAdapter (Context context, int textViewResourceld, List<T> objects) 

其 中 ， 第 一 个 参数 是 上 下 文 环境 ， 第 二 个 参数 是 显示 的 布局 资源 Id 号 ， 第 三 个 参数 是 
数据 对 象 。 以 构造 一 个 Android 系统 定义 的 下 拉 列 表 显 示 布 局 ， 显 示 filenames 数组 内 容 为 
例 ， 代 码 如 下 : 


madpter = new ArrayAdapter<String> (context, 
android.R.layout.simple spinner item, filenames); 


(2) 数据 适配器 和 下 拉 列 表 关 联 ， 使 用 方法 : 

setAdapter (SpinnerAdapter adapter) 

其 中 ， 参 数 是 提供 显示 数据 的 数据 适配器 。 以 显示 madpter 为 例 ， 代 码 如 下 : 
m spinner.setAdapter (madpter); 

(3) 选择 内 容 


为 了 获得 用 户 选 择 的 选项 ， 需 要 设计 OnItemSelectedListener 监听 ， 并 且 实 现 其 
onltemSelected: 











onItemSelected (AdapterView<?> parent, View view, int position, long id) 

其 中 ， 第 一 个 参数 是 发 生 选择 事件 的 适配器 控件 ， 第 二 个 参数 是 被 选择 的 视图 ， 第 三 
个 参数 是 视图 在 适配器 中 的 位 置 索引 号 ， 第 四 个 参数 是 被 单 击 条 目的 行 4。 使 用 索引 号 就 
可 以 从 原始 数据 数组 中 获得 对 应 的 值 ， 并 设置 显示 项 。 代 码 如 下 : 

copy path = files.get (position); // 获 得 需 复 制 文件 的 全 路 径 
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Parent .setVisibility (View.VISIBLE); // 设 置 显示 选择 项 




















熟悉 了 下 拉 列 表 的 设置 过 程 ， 就 可 以 实现 显示 f 包 enames 的 内 容 、 将 用 户 的 选择 显示 在 


列表 中 并 获得 用 户 选择 文件 的 完整 路 径 ， 具 体 代码 如 下 : 


01 private Spinner m spinner; // 定 义 下 拉 控 件 
02 private ArrayAdapter<String> madpter; // 定 义 下 拉 控 件数 据 适配器 
03 private String copy path = ""; // 定 义 辅助 文件 全 路 径 
04 madpter = new ArrayAdapter<String> (context, 
05 android.R.layout.simple spinner item, filenames); 
// 实 例 化 数据 适配器 
06 madpter .setDropDownViewResource (android.R.layout.simple 
spinner dropdown item); 
// 设 置 下拉 列 表 的 显示 样式 
07 m spinner.setAdapter (madpter); // 设 置 下 拉 控 件 的 数据 适配器 
08 // 选 择 监听 
09 m spinner.setOnItemSelectedListener (new 
Spinner.OnItemSelectedListener() { 
10 QOverride ”// 选 中 下 拉 列 表 项 时 处 理 方法 
ll public void onItemSelected (AdapterView<?> parent, 
人 第 妇 View view, int position, long id) { 
13 //TODO Auto-generated method stub 
14 // 获 得 需 复制 文件 的 全 路 径 
15 copy path = files.get(position); 
16 // 设 置 显 示 选 择 项 
Elyy Parent.setVisibility (View .VISIBLE); 
18 | 
19 
20 @Override 
人 public void onNothingSelected (AdapterView<?>parent) { 
区 //TODO Ruto-generated method stub 
23 } 
24 nb 


其 中 ，01 一 03 行 ， 定义 和 初始 化 下 拉 列 表 、 数 据 适 配器 以 及 用 于 记录 复制 文件 的 全 路 


径 的 String; 


04 一 07 行 ， 用 于 设置 下 拉 列 表 。04 一 05 行 ， 实 现 ArrayAdapter 与 数据 filenames 的 关 
联 ; 第 06 行 ， 设 置 下 拉 列 表 的 风格 ; 第 07 行 ， 将 ArrayAdapter 添加 到 m_spinner 中 ; 

08 一 24 行 ， 给 下 拉 列 表 添 加 选择 监听 事件 。11 一 18 行 ， 下 拉 列 表 中 选择 时 ， 获 得 选 
择 的 项 并 显示 选择 项 ; 20 一 24 行 ， 是 继承 OnItemSelectedListener 类 必须 重 写 的 方法 , 可 以 


不 做 任何 操作 ， 运 行 效果 如 图 4.12 所 示 。 
4. 复制 文件 
选择 了 需 复制 的 文件 ， 接 下 来 就 是 最 重要 的 复制 文件 过 程 。 


从 程序 目录 中 复制 文件 到 SD 卡 中 ， 首 先 判断 SD 卡 是 否 可 以 使 用 ， 然 后 读 取 程 序 目 
录 中 的 文件 到 输入 流 InputStream 中 ， 最 后 将 读 取 的 文件 写 入 到 输出 流 OutputStream 中 。 
梳理 清楚 了 复制 文件 的 过 程 ， 相 关 的 操作 都 已 经 掌握 了 ， 下 面 直 接 看 代码 实现 : 





01 if (Environment .getExternalStorageState () .equals ( 
02 android.os.Environment .MEDIA MOUNTED)) { 
// 判 断 SD 卡 是 否 准备 就 绪 


03 if (!copy path-equals("")) { // 判 断 复 制 文件 路 径 是 否 为 空 
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04 String sd filename = copy path.substring(copy path 
-lastIndexOf ('/')); // 获 取 文 件 名 
05 save to sd(copy path, 
06 Environment .getExternalStorageDirectory() . 
getPath()+ "/" + sd filename) 7 
// 调 用 文件 复制 到 SD 卡 的 方法 
07 } 
08 } 
09 
10 // 将 数据 保存 到 SD 卡 
ll private void save to sd(String from path, String sd path) { 
有 try { 
TS File fromFile = new File(from path);  // 获 取 源 文件 类 
14 if (!fromFile.exists()) { 
// 如 果 该 源 文件 不 存在 ， 则 给 出 提示 并 返回 

15 System.out .println (" 程 序 中 不 存在 " + from path); 
16 return; 
工 7 1 
18 
19 File sd File = new File(sd path);  // 获 取 SD 卡 中 目标 文件 类 
20 InputStream in = new FileInputStream(fromFile); 

// 实 例 化 源 文件 输入 流 
2 让 OutputStream out = new FileOutputStream(sd File); 

// 实 例 化 日 标 文件 输出 流 
22 byte[] buf = new byte[1024]; // 输 入 输出 缓存 
23 int len; 
24 while ((len = in.read(buf)) > 0) { // 读 取 输入 流 到 缓存 中 
25 out.write(buf, 0, len); // 将 缓存 写 入 输出 流 中 
26 1 
2 in.close(); // 关 闭 输入 流 
28 out.close(); // 关 闭 输 出 流 
29 Toast .makeText (context，" 完 成 文件 复制 "，1000) .show() ; 
30 } catch (Exception e) { 
3 // TODO: handle exception 
3 System.out.println("save to sd " + e.toSstring()); 
33 1 
34 
35 } 


其 中 ，01 一 02 行 ， 判断 SD 卡 的 状态 ，SD 卡 是 否 存 在 并 可 以 读 写 ， 可 以 读 写 则 进行 
文件 操作 ， 和 否则 退出 ; 

03 行 ， 判 断 需 要 复制 的 文件 的 全 路 径 ， 为 空 值 则 路 径 有 错 ， 退 出 文件 操作 ; 

04 行 ， 从 文件 全 路 径 中 获得 文件 的 名 称 ， 该 名 称 便 是 保存 到 SD 卡 中 的 文件 的 名 称 ; 

05 一 06 行 ， 调 用 复制 文件 函数 ， 第 一 个 参数 是 需 复制 文件 的 全 路 径 ， 即 程序 目录 下 文 
件 的 全 路 径 ， 第 二 个 参数 是 复制 到 的 全 路 径 ， 即 SD 卡 中 文件 的 全 路 径 。 复 制 文件 函数 的 
实现 是 10 一 35 行 ; 

12 一 17 行 ， 判 断 需 复制 文件 是 否 存在 ， 若 不 存在 则 提示 “文件 不 存在 ”并 退出 ; 

19 一 21 行 , 分 别 给 复制 文件 提供 输入 流 InputStream, 给 复制 到 的 目的 文件 提供 输出 流 
OutputStream:; 

22 一 35 行 ， 使 用 缓冲 区 读 取 输 入 流 中 的 数据 ， 并 将 数据 写 入 到 输出 流 中 。 成 功 则 关闭 
输入 、 输 出 流 ， 并 提示 复制 成 功 ; 若 出 现 异 常 ， 则 打印 异常 信息 ,运行 效果 如 图 4.11 所 示 。 
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5. 运行 分 析 总 结 


对 程序 进行 调试 运行 ， 最 终 成 功 地 将 程序 目录 下 的 文件 com.ouling.ex_file/files/Justin 
Bieber-Baby.mp3 复制 到 SD 卡 中 ， 如 图 4.13 所 示 。 
等 Threads | 目 Heap | 目 如 location Tracker 者 rile Explorer bq 和 


© GB com ouling ex_file 
由 世 cache 







08-19 





间 820 
Blib 2011-08-16 
BB con. ouling ex_notes 2011-08-19 
BG eon. svox. pico 2010-10-10 
BB eon test 2011-08-30 
田 世 co thj. diary 2011-08-19 
GB jp. eo. omronsoft. opemmmm 2010-10-11 
困 世 org openintents sensorsimd 2011-08-27 
WB aontpanic 2010-10-10 
田 世 leeu 2010-10-10 
由 世 losttfound 2010-10-10 
BH Bnise 2010-10-10 
WB property 2011-07-04 
WB syste 2011-08-31 
SBmt 2011-08-31 
WB GC asee 2011-08-31 
Er -01 

上 Jastin Bisber-Baby. mp3 1735679 2011 
BS LDST. IR 2010-10-10 





图 4.13 完成 复制 结果 


在 成 功 地 实现 文件 的 复制 过 程 中 ， 我 们 除了 重点 使 用 对 文件 的 操作 ， 还 使 用 了 指定 文 
件 夹 路 径 下 ， 包 括 子 文件 夹 中 的 所 有 文件 的 遍历 获取 ;下拉 列 表 的 显示 数据 关联 和 选择 事 
件 处 理 。 

对 程序 目录 下 的 文件 进行 导出 ， 不 仅 是 练习 文件 操作 的 基本 方法 ， 在 实际 开发 过 程 中 
也 是 经 常 使 用 的 功能 。 在 实际 的 真 机 测试 中 ， 由 于 Android 为 了 保护 程序 数据 的 安全 ， 是 
禁止 直接 查看 、 获 取 程 序 目录 下 的 数据 的 。 所 以 ， 不 能 如 图 4.13 一 样 查看 到 所 有 程序 目录 
中 的 数据 。 这 时 候 ， 就 有 必要 导出 程序 目录 的 文件 并 分 析 获 得 的 数据 、 调 试 信息 文件 等 。 
而 且 文件 的 复制 不 仅仅 用 于 程序 到 SD 卡 ， 也 是 在 SD 卡 到 程序 目录 、SD 卡 中 不 同 路 径 之 
间 都 是 会 使 用 到 的 功能 。 


4.4 数据 库存 储 


前 面 介绍 了 SharedPreferences 和 文件 存储 两 种 数据 存储 方式 ， 它 们 对 单个 、 不 具有 关 
联 性 的 数据 存储 使 用 方便 ， 但 是 对 于 一 组 具有 相同 或 相近 格式 的 数据 进行 存储 、 管 理 时 就 
显得 难以 完成 。 为 了 实现 相近 格式 数据 的 添加 、 删 除 、 修 改 以 及 更 新 ,Android 通过 SQLite 
数据 库 引 擎 来 实现 结构 化 数据 的 存储 和 管理 。Android 系统 本 身 自 带 的 很 多 应 用 也 是 使 用 
SQLite 数据 库 来 存储 数据 的 ， 如 通讯 录 、 短 信 、 通 话 记录 等 。 

SQLite 是 一 个 嵌入 式 数据 库 引擎 ,针对 内 存 等 资源 有 限 的 设备 提供 的 一 种 高 效 的 数据 
库 引擎 。SQLite 数据 库 不 同 于 其 他 的 数据 库 ， 它 没有 服务 器 进程 ， 只 需要 一 个 动态 库 就 可 
以 使 用 其 全 部 功能 。SQLite 数据 库 的 所 有 内 容 包含 在 同一 个 文件 中 ， 可 以 自由 复制 。 
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下 面 ， 我 们 将 熟悉 Android 中 数据 库 的 基本 操作 ， 即 数据 库 的 创建 和 删除 、 表 的 创建 
和 删除 ， 以 及 数据 的 添加 、 删 除 、 修 改 以 及 查询 等 操作 。 后 面 我 们 还 将 使 用 这 些 数据 库 操 
作 来 读 取 通讯 录 和 实现 自己 的 日 记 本 操作 。 


4.4.1 学 生 信息 数据 库 的 创建 和 删除 


1. 功能 说 明 


需要 在 界面 中 提供 “新 建 数据 库 ” 和 “删除 数据 库 ” 两 个 按钮 来 分 别 实现 对 数据 库 的 
创建 和 删除 ， 效 果 如 图 4.14 和 图 4.15 所 示 。 


mp 


[21] 


新 建 数据 库 


成 功 创建 数据 库 成 功 删除 数据 库 





图 4.14 创建 数据 库 图 4.15 删除 数据 库 


2. 数据 库 的 辅助 类 一 一 SQLiteOpenHelper 


在 Android 中 ， 管 理 数据 库 使 用 到 辅助 类 SQLiteOpenHelper。 这 个 类 主要 用 于 生成 一 
个 数据 库 ， 并 对 数据 库 的 版 本 进行 管理 。 当 在 程序 中 调用 这 个 类 的 方法 getWritable 
Database(), 或 者 getReadableDatabase() 方 法 时 ， 如 果 当 时 数据 库 中 没有 数据 ,那么 Android 
系统 就 会 自动 调用 onCreate(SQLiteDatabase db) 方 法 生成 一 个 数据 库 。 

SQLiteOpenHelper 是 一 个 抽象 类 ， 通 常 需要 继承 它 ， 并 且 实 现 3 个 基本 函数 。 构 造 函 
数 如 下 : 

SQLiteOpenHelper (Context context, String name, SQLiteDatabase. 

CursorFactory factory, int version) 


其 中 ， 第 一 个 参数 是 上 下 文 环境 ， 第 二 个 参数 是 数据 库 的 名 称 ， 第 三 个 参数 一 般 设 置 
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为 null， 第 四 个 参数 是 版 本 号 。 返 回 一 个 SQLiteOpenHelper， 用 于 数据 库 的 管理 。 创 建 数 
据 库 : 

onCreate (SQLiteDatabase db) 

该 函数 在 数据 库 第 一 次 生成 的 时 候 调 用 。 一 般 在 这 个 方法 里 用 来 生成 数据 库 的 表 。 数 
据 库 版 本 更 新 : 

onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) 

该 函数 是 数据 库 的 版 本 更 新 的 时 候 调 用 。 一 般 默认 情况 下 ， 当 我 们 插入 数据 库 就 立即 
更 新 ， 当 数据 库 需 要 升级 的 时 候 ，Android 系统 会 主动 地 调用 这 个 方法 。 一 般 我 们 在 这 个 
方法 里 删除 数据 表 ， 并 建立 新 的 数据 表 。 

熟悉 了 SQLiteOpenHelper 类 的 作用 ， 我 们 来 实现 自己 的 数据 库 辅 助 类 DB_helper。 它 
用 来 管理 学 生 信息 数据 库 OuLing.db， 当 数据 库 第 一 次 生成 时 ， 生 成 一 张 名 为 student info 
的 表 来 记录 学 生 的 姓名 和 学 号 。 有 具体 代码 如 下 : 

01 public class DB helper extends SQLiteOpenHelper { // 继 承 数 据 库 辅助 类 

















02 public final static int VERSION = 1; // 版 本 号 
03 public final static String TABLE NAME = "student info"; 
// 表 名 
04 public static final String DATABASE NAME = "OuLing.db"; 
// 数据 库 名 
05 
06 public DB helper (Context context) { // 构 造 函 数 
07 super (context, DATABASE NAME, null, VERSION); 
08 } 
09 
10 @Override 
了 // 在 数据 库 第 一 次 生成 的 时 候 会 调用 这 个 方法 ， 一 般 我 们 在 这 个 方法 里 生成 数据 库 表 
12 Public void onCreate (SQLiteDatabase db) { 
13 String str sql = "CREATE TABLE " + TABLE NAME 
14 + "(id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR,number 
VARCHAR) ;"; 
1 // 使 用 SQL 语句 CREATE TABLE 创建 一 张 表 
16 db.execSQL (str_sql) : 
a // execSQL () 方 法 用 于 执行 一 句 SQL 语句 ， 传 入 的 str_sql 语句 表示 创建 表 
18 } 
19 
20 QOverride  // 数 据 库 更 新 
2 Public void onUpgrade (SQLiteDatabase db, int oldVersion, int 
newVersion) { 
22 System.out .println("student info db onUpgrade") 
23 } 
24 
Pd 


其 中 ，01 行 ， 类 DB_helper 继承 自 SQLiteOpenHelper， 用 于 对 自 定义 数据 库 的 管理 。 
该 类 具体 实现 了 构造 函数 、 创 建 函数 以 及 版 本 更 新 函数 ; 

02 一 04 行 ， 对 数据 库 名 、 数 据 库 版 本 号 、 初 始 表 名 的 定义 ; 

06 一 08 行 ， 实 现 DB_helper 的 构造 函数 。 当 DB_helper 初始 化 时 便 定义 数据 库 的 名 称 
为 OuLing.db 和 版 本 号 为 1; 

10 一 18 行 ， 实 现 创 建 函 数 onCreate。 其 实现 了 数据 库 生 成 时 ， 创 建 了 一 个 名 为 
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student info 的 表 。 如 何 实现 表 的 创建 在 接 下 来 的 章节 会 详细 讲解 
21 一 23 行 ， 实 现 更 新 函数 onUpgrade。 由 于 我 们 的 数据 库 没有 更 新 变化 ， 所 以 没有 实 
现 的 内 容 。 但 是 这 个 函数 是 继承 自 SQLiteOpenHelper 抽象 类 的 虚 函 数 ， 必 须 存 在 。 


3. 数据 库 的 创建 和 删除 


实现 了 自 定义 的 数据 库 管理 类 后 ， 只 需要 调用 其 getWritableDatabase() 方 法 或 者 
getReadableDatabase() 方 法 ， 系 统 便 会 调用 onCreate 来 创建 数据 库 。 

这 里 需要 注意 的 是 ， 当 我 们 实例 化 MySQLiteOpenHelper 类 对 象 时 并 没有 创建 数据 库 ， 
而 是 在 调用 getWritableDatabase() 方 法 或 者 getReadableDatabase() 方 法 得 到 数据 库 读 写 句 柄 
的 时 候 ，Android 会 分 析 是 否 已 经 有 了 数据 库 。 如 果 没 有 会 默认 创建 一 个 数据 库 并 且 在 系 
统 路 径 下 生成 数据 库 文件 。 

删除 数据 库 ， 只 需要 直接 调用 Context 的 方法 : 


deleteDatabase (String name) 


其 中 ， 参 数 为 数据 库 的 名 称 。 使 用 该 方法 就 能 直接 删除 该 Context 应 用 查询 的 私有 数 





熟悉 了 数据 库 的 创建 和 删除 后 ， 实 现 创建 一 个 数据 库 并 删除 该 数据 库 ， 代 码 如 下 : 

01 Fry 4 

02 switch (v.getId()) { 

03 // 新 建 数据 库 

04 case R.id.sql newdb: 

05 mDbHelper = new DB helper (context); 

06 // 调 用 getReadableDatabase 方法 , 如 果 数 据 库 不 存在 则 创建 ， 

如 果 存 在 则 打开 

07 mdb = mDbHelper .getReadableDatabase(); 

08 Toast .makeText (context，" 成 功 创建 数据 库 "，1000) .show (); 

09 break; 

10 // 删 除数 据 库 

11 case R.id.sql deldb: 

2 mDbHelper = new DB helper (context); 

3 mdb = mDbHelper .getReadableDatabase(); 

14 // 关 闭 数据 库 

15 mdb.close(); 

16 // 删 除数 据 库 

hh if (context.deleteDatabase (DB helper.DATABASE 

NAME)) { 

18 Toast .makeText (context， "成功 删 除数 据 库 "， 
1000) .show(); 

9 } 

20 break; 

21 } catch (Exception e) { 

有 2& //TODO: handle exception 

3 System.out .println(e.toSstring()); 

24 } finally { 

05 // 如 果 发 生 异常 ， 同 样 需要 对 数据 库 进 行 关闭 

26 mdb.close(); 

攻 寺 4 灿 








其 中 ，01 一 09 行 ， 使 用 创建 DB_helper 来 创建 数据 库 。 需 要 强调 的 是 在 05 行 new 
DB_helper(context) 并 没有 创建 数据 库 , 而 是 在 07 行 mdb = mDbHelper.getReadable Database()， 
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系统 分 析 没 有 数据 库 而 在 系统 路 径 下 生成 数据 库 文件 OuLing.db， 效 果 如 图 4.14 所 示 ; 

11 一 20 行 ， 删 除数 据 库 ， 效 果 如 图 4.15 所 示 ; 

21 一 27 行 ， 异常 处 理 。 在 数据 库 操作 中 需要 充分 考虑 的 , 特别 是 在 finally 关闭 数据 库 
时 。 如 果 数 据 库 没 有 关闭 ， 当 其 他 地 方 使 用 数据 库 时 就 会 发 生 错误 ， 所 以 使 用 完 后 不 要 态 
记 关闭 数据 库 。 

4. SD 卡 数据 库 的 创建 和 删除 


前 面 使 用 到 的 数据 库 的 创建 和 删除 都 是 在 程序 目录 下 进行 的 ， 是 程序 的 私有 数据 ， 其 
他 程序 是 无 法 使 用 的 。 如 果 需 要 数据 库 与 其 他 程序 进行 共享 ， 可 以 将 数据 库 保 存在 SD 卡 中 。 

数据 库 保存 到 SD 卡 中 , 和 普通 文件 保存 到 SD 卡 一 样 , 首先 需要 在 配置 文件 Android- 
Mainfest.xml 中 声明 写 入 SD 卡 的 权限 ， 然 后 确认 SD 卡 是 否 可 用 。 这 些 都 在 上 一 节 文 件 存 
储 中 介绍 过 的 。 下 面 看 看 SD 卡 中 数据 库 文件 使 用 时 需要 注意 的 地 方 。 

创建 数据 库 时 ， 使 用 SQLiteDatabase 类 中 的 openOrCreateDatabase() 方 法 来 实现 。 这 种 
方法 会 自动 检测 是 否 存在 指定 数据 库 ， 如 果 存 在 则 打开 ， 如 果 不 存在 则 创建 一 个 数据 库 ; 
创建 成 功 则 返回 一 个 SQLiteDatabase 对 象 ， 否 则 抛 出 异常 。 该 方法 有 多 种 实现 ， 最 常 使 用 
的 两 种 方式 如 下 : 





openOrCreateDatabase (String path, SQLiteDatabase.CursorFactory factory) 
openOrCreateDatabase (File file, SQLiteDatabase.CursorFactory factory) 


第 一 种 实现 中 ， 第 一 个 参数 是 文件 路 径 ， 该 路 径 是 数据 库 的 全 路 径 ， 第 二 种 实现 中 ， 
第 一 个 参数 是 文件 ， 即 已 经 在 SD 卡 中 存在 的 数据 库 文件 。 
删除 SD 卡 中 的 数据 库 ， 即 删除 该 数据 库 文 件 即 可 。 例 如 : 


File del f = new File("/sdcard/ouling/OuLing.db");// 创 建文 件 
del fdelete()s 


熟悉 了 SD 卡 中 数据 库 的 创建 和 删除 过 程 ， 我 们 将 上 例 中 的 数据 库 创建 在 SD 卡 中 ， 
具体 实现 如 下 : 


01 try { 

02 Switch (v.getId()) { 

03 // 新 建 数据 库 

04 case R.id.sql newdb: 

05 // 以 下 两 个 成 员 变量 是 针对 在 SD 卡 中 存储 数据 库 文件 使 用 

06 File path = new File("/sdcard/ouling") 
// 创 建 目录 

07 File f = new File("/sdcard/ouling/OuLing.db"); 
// 创 建文 件 

08 // 如 果 你 使 用 的 是 将 数据 库 的 文件 创建 在 SD 卡 中 ， 那 么 创建 数据 库 

mysql 进行 如 下 操作 : 

09 if (!path.exists()) { 

10 path.mkdirs(); // 创 建 一 个 目录 

是 世 } 

4 1F (Farists()) 

Ee try { 

14 f.createNewFile(); // 创 建文 件 

15 } catch (IOException e) { 

16 // TODO Auto-generated catch block 


下 生生 
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入 e-printStackTrace (); 

18 } 

19 } 

20 // 将 数据 库 的 文件 创建 在 SD 卡 中 

2 mdb = SQLiteDatabase .openOrCreateDatabase (f, null); 
B24 Toast .makeText (context，" 成 功 创建 数据 库 "，1000) .show (); 
2 break; 

24 // 删除 数据 库 

Pa case R.id.sql deldb: 

26 // 删除 SD 卡 中 的 数据 库 

27 File del f = new File("/sdcard/ouling/OuLing.db"); 
28 if (del 和 -exists《)) 4 

29 del f.delete(); 

30 } 

ol Toast .makeText (context，" 成 功 删 除数 据 库 "，1000) .show () ; 
32 break; 

a3 } catch (Exception e) { 

34 // TODO: handle exception 

5 System-out .Println(e.toString()) 7 

36 站 inably 

37 // 如 果 发 生 异 常 ， 同 样 需要 对 数据 库 进行 关闭 

38 mdb.close(); 

39 } 


其 中 ，01 一 19 行 ， 在 指定 的 路 径 /sdcard/ouling 下 创建 了 数据 库 文件 OuLing.db。 这 些 


处 理 都 是 文件 存储 中 使 用 过 的 ， 相 信 大 家 不 会 陌生 ; 


20 一 23 行 ， 使 用 创建 的 文件 来 创建 数据 库 ， 返 回 可 操作 的 SQLiteDatabase 对 象 ， 实 现 


效果 如 图 4.14 所 示 ; 


24 一 32 行 ， 删 除数 据 库 。 使 用 直接 删除 文件 的 方法 ， 实 现 效果 如 图 4.15 所 示 ; 


33 一 39 行 ， 异 常 处 理 以 及 关闭 数据 库 。 


5. 运行 分 析 总 结 


对 程序 进行 调试 运行 ， 查 看 程序 目录 下 的 文件 。 创 建 数据 库 后 ， 在 程序 目录 
com.ouling.ex_db 下 多 了 文件 夹 databases 以 及 文件 OuLing.db， 如 图 4.16 所 示 。 删 除数 据 
库 后 ， 程 序 目 录 中 的 文件 夹 databases 存在 而 文件 OuLing.db 已 经 被 删除 ， 如 图 4.17 所 示 。 





| 等 Thraads | 目 Haap | 目 内 lcation Tracker 












由 GB com. leno. test_GFS 
区 com.leno.test_file 
由 世 com. ouling. ex_apk_share 
由 全 com. ouling ex_contacts 
BB con. ouling ex_db 
日 世 databases 
全 OuLing db 
田 马 1ib 
由 con. ouling. ex_file 
由 世 con. ouling. ex_notes 


图 4.16 成 功 创建 数据 库 


已 经 成 功 实现 了 在 程序 目录 和 SD 卡 创建 数据 库 和 删除 数据 库 ， 下 面 来 总 结 一 下 在 程 


序 目录 和 SD 卡 中 创建 、 删 除数 据 库 的 区 别 。 


和 2 


Size Date 


2011-08-25 
2011-08-31 
2011-08-09 
2011-09-03 
2011-09-04 
2011-09-04 


5120 2011-09-04 


2011-09-04 
2011-08-30 
2011-08-19 
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| 等 Threads Heap | 四 如 location Tracker | File Explorer 23 








| Hane Size Date Tine 
| 画 区 com leno. test_GPS 2011-08-25 22:47 
EE com. leno. test_file 2011-08-31 23:39 

EE com. ouling ex_apk_share 2011-08-09 23:47 

EE com ouling ex_contacts 2011-09-03 20:25 

| SE con. ouling ex_b 2011-09-04 ”12:38 
ee 
画 世 li 2011-09-04 ”12:33 

EE con. ouling ex_file 2011-08-30 22:17 
EG con. ouling. ex_notes 2011-08-19 21:21 


图 4.17 成 功 删 除数 据 库 


如 果 使 用 系统 默认 路 径 存 储 数据 库 文件 ， 可 以 分 为 3 步 : 

第 一 步 : 新 建 一 个 类 继承 SQLiteOpenHelper， 写 一 个 构造 ， 重 写 两 个 函数 ; 

第 二 步 : 在 新 建 类 中 的 重 写 函 数 onCreate(SQLiteDatabase db) 中 创建 一 个 表 ; 

第 三 步 : 使 用 新 类 来 创建 数据 库 以 及 使 用 deleteDatabase 方法 来 删除 数据 库 。 

如 果 使 用 SD 卡 存储 数据 库 文件 ， 就 没有 必要 写 这 个 继承 SQLiteOpenHelper 的 类 ， 而 
是 直接 openOrCreateDatabase 一 个 文件 得 到 一 个 数据 库 ， 也 可 以 分 为 3 步 : 





第 一 步 : 在 配置 文件 AndroidMainfestxml 中 声明 写 入 SD 卡 的 权限 ; 

第 二 步 : 确认 SD 卡 是 否 可 以 使 用 ， 并 在 SD 卡 指定 路 径 创 建 数据 库 文 件 ; 

第 三 步 : 使 用 openOrCreateDatabase 来 得 到 数据 库 文件 并 通过 直接 删除 文件 来 删除 数 
据 库 。 


4.4.2 ”学生 信息 表 的 创建 和 删除 


1. 功能 说 明 

在 上 一 小 节 中 ， 我 们 掌握 了 数据 库 的 创建 和 删除 ， 接 下 来 实现 对 数据 库 中 表 的 创建 和 
删除 。 在 上 例 中 ， 添 加 “新 建 一 张 数据 表 ” 和 “删除 一 张 数 据 表 ”两 个 按钮 ， 分 别 用 于 实 
现 对 数据 库 中 表 的 创建 和 删除 ， 效 果 如 图 4.18 和 图 4.19 所 示 。 


成 功 创建 一 张 新 表 成 功 删除 表 





图 4.18 创建 表 图 4.19 删除 表 


a 
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2. sql 语 句 


SQLite 是 支持 SQL 语言 的 ,所 以 Android 提供 的 SQLiteDatabase 类 也 有 直接 执行 SQL 
语言 的 方法 : 
execSQL (String sql) 


其 中 ， 参 数 为 sql 语句 。 语 法 和 SQL 语言 是 一 样 的 ， 以 上 小 节 中 SQLiteOpenHelper 
中 创 表 的 语句 为 例 ; 
String str sql = "CREATE TABLE " + TABLE NAME 
+ "(id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR, number 
VARCHAR); "; 
此 名 用 来 创建 一 个 表 名 为 TABLE_NAME 的 表 ， 即 student info 的 表 。 表 中 有 三 列 ， 
- 列 名 为 id, 是 INTEGER 类 型 数据 , 作为 主键 , 并 且 具 有 自 增 的 属性 , AUTOINCREMENT 
标识 数据 库 会 为 每 条 记录 的 key 加 一 ， 确 保 记 录 的 唯一 性 ， 并 且 该 值 不 会 因为 删除 数据 而 
改变 ， 新 的 数据 到 来 时 ， 继 续 在 原 有 记录 值 上 递增 。 一 列 名 为 name， 类 型 是 VARCHAR， 
用 于 记录 学 生 的 姓名 ; 一列 名 为 number， 类 型 是 VARCHAR， 用 于 记录 学 生 的 学 号 。 


(1) Android 中 的 SQLite 语法 大 小 写 不 敏感 ， 也 就 是 说 不 区 分 大 小 写 。 

(2) sql 语句 中 每 个 关键 词 之 间 都 是 用 空格 隔 开 的 ， 特 别 需 要 注意 的 是 ， 在 "CREATE 
TABLE "+ 时 ，E 和 引号 之 间 有 一 个 空格 ， 避 免 了 TABLE 和 TABLE_NAME 被 连接 为 一 
个 词 。 


3. 创建 和 删除 表 


创建 表 和 删除 表 ， 使 用 的 方法 都 是 一 样 的 ， 都 是 通过 执行 sql 语句 来 实现 的 。 创 建 表 
语句 已 经 了 解 了 ， 删 除 表 也 非常 简单 : 
String str sql = "DROP TABLE "+ TABLE NAME; 
熟悉 了 创建 表 和 删除 表 的 过 程 ， 来 实现 创建 一 张 名 为 New_table 的 表 。 表 中 有 两 列 ， 
- 列 名 为 ia， 是 自 增 的 INTEGER 类 型 主键 ， 一 列 名 为 name 的 VARCHAR 类 型 。 然 后 删 
除 该 表 ， 实 现代 码 如 下 : 


01 try { 

02 // 新 建 表 

03 case R.id.sql newtable: 

04 try { 

05 mdb = mDbHelper .getWritableDatabase(); 

// 获 取 数 据 库 辅助 类 

06 String str sql = "CREATE TABLE New table (id 
INTEGER 

07 PRIMARY KEY AUTOINCREMENT,name VARCHAR);"; // 创 建 表 的 sql 语句 

08 mdb.execSQL(str sql); // 执 行 sql 语句 

09 Toast .makeText (context， "成功 创 建 一 张 新 表 "， 
1000) .show(); 

10 } catch (Exception e) { 

让 Toast .makeText (context，" 该 表 已 经 存在 "， 


1000) .show(); 
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12 » 

3 break; 

14 // 删除 表 

5 case R.id.sql deltable: 

16 try { 

17 mdb = mDbHelper .getWritableDatabase(); 

// 获 取 数 据 库 辅 助 类 
18 String str sql = "DROP TABLE New table"; 
// 删 除 表 的 sql 语句 

19 mdb.execSQL(str sql); // 执 行 sql 语句 

20 Toast .makeText (context， "成功 删 除 表 "， 
1000) .show(); 

(nl } catch (Exception e) { 

Ei4 // TODO: handle exception 

23 Toast .makeText (context， "要求 删除 的 表 不 存在 "， 
1000) .show() > 

24 FS 

25 break; 

26 } catch (Exception e) { 

Ey //TODO: handle exception 

28 System.out.println(e.toString()); 

29 } finally { 

30 // 如 果 发 生 异 常 ， 同 样 需要 对 数据 库 进行 关闭 

3 mdb.close(); 

3 


其 中 ，01 一 13 行 ， 创 建 满足 条 件 的 表 。 需 要 注意 的 是 05 行 ， 获 得 的 数据 库 是 系统 目 
录 下 的 数据 库 ， 如 果 要 使 用 SD 卡 的 数据 库 ， 只 需要 将 其 修改 为 mdb = SQLiteDatabase. 
openOrCreateDatabase(f null); 其 他 操作 都 是 相同 的 ， 效 果 如 图 4.18 所 示 ; 

14 一 25 行 ， 删 除 表 名 为 New_table 的 表 。 如 果 使 用 SD 卡 的 数据 库 ， 方 法 同上 ， 效 果 


如 图 4.19 所 示 ; 


26 一 32 行 ， 异 常 处 理 以 及 关闭 数据 库 。 


4. 运行 分 析 总 结 


对 程序 进行 调试 运行 ,将 系统 目录 下 的 数据 库 OuLing.db 导出 ,使 用 SQLite 数据 库 查 
看 工具 查看 。 推 荐 使 用 SQLiteSpy.exe 进行 查看 。 在 SQLiteSpy 菜单 栏 中 ， 选 择 File， 在 下 
拉 菜 单 中 选择 open Database 打开 数据 库 , 然后 选择 需要 查看 的 数据 库 文件 即 可 。 需要 查看 
表 的 信息 ， 则 双击 该 表 ， 即 可 在 右边 看 到 表 内 的 记录 。 

创建 表 后 ， 数 据 库 有 4 张 表 ， 其 中 就 有 New_table， 如 图 4.20 所 示 ; 删除 表 后 数据 库 





只 剩 下 3 张 表 ， 如 图 4.21 所 示 。 
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图 4.20 创建 表 图 4.21 删除 表 
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其 实 ， 创 建 表 和 删除 表 都 是 使 用 了 execSQL(String sqD) 来 执行 sql 语句 ， 所 以 创 表 和 删 
表 的 关键 在 于 熟悉 sql 语句 。 本 书 只 讲解 最 常 使 用 的 sql 语句 ， 复 杂 的 语句 请 查看 SQL 相 
关 书 籍 。 


4.4.3 学生 信 息 的 增删 改 查 








1. 功能 说 明 

数据 库 中 对 数据 的 操作 就 是 增删 改 查 4 种 经 典 操作 。 这 一 小 节 ， 就 将 分 别 实现 对 数据 
的 添加 、 删 除 、 修 改 和 查询 操作 。 在 上 一 小 节 示 例 的 界面 中 ,添加 “ 表 中 添加 一 条 记录 ”、 
“ 表 中 删除 一 条 记录 ”、“ 表 中 修改 一 条 记录 ”以 及 “查询 表 中 所 有 记录 ”4 个 按钮 ， 分 别 
来 实现 对 应 的 数据 的 增删 改 查 ， 界 面 效果 如 图 4.22 和 图 4.23 所 示 。 





(70 13 | 771279 


删除 数据 库 


新 建 一 张 数据 表 


删除 一 张 数据 表 


表 中 添加 一 条 记录 表 中 添加 一 条 记录 


成 功 添加 数据 成 功 删 除数 据 


表 中 修改 一 条 记录 表 中 修改 一 条 记录 


查询 表 中 所 有 记录 查询 表 中 所 有 记录 





图 4.22 查看 添加 数据 图 423 ”成功 删除 数据 

2. 添加 学 生 信 息 

添加 数据 的 方式 有 两 种 : 

(1) 第 一 种 是 使 用 SQLiteDatabase 提供 的 insert 方法 : 

insert (String table, String nullColumnHack, ContentValues values) 

其 中 ， 第 一 个 参数 是 表 名 ， 第 二 个 参数 默认 为 null 即 可 ， 第 三 个 参数 是 输入 的 数据 。 
ContentValues 其 实 就 是 一 个 哈 希 表 HashMap， 以 键 值 对 的 方式 保存 数据 。 通 过 ContentValues 
的 put 方法 就 可 以 把 数据 放 到 ContentValues 中 : 


put (String key, String value) 
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其 中 ，key 值 是 字段 名 称 即 表 中 的 列 名 ，Value 值 是 字段 的 值 即 添加 的 值 。 例 如 ， 向 表 
student_info 中 的 添加 一 个 名 为 “ 欧 零 ”， 学 号 为 1 的 学 生 信息 ， 实 现 如 下 : 

ContentValues add cv = new ContentValues(); 

add cv.put ("name"，" 欧 零 "); 

add cv.put ("number", "1"); 

(2) 第 二 种 是 使 用 SQL 语句 实现 。 添 加 记录 的 sql 语句 为 : 

INSERT 表 名 ( 列 名 ， 列 名 ) values ( 值 1, 值 2) 

例如 ， 同 样 是 向 表 student info 中 添加 一 个 名 为 “ 欧 零 ”， 学 号 为 1 的 学 生 信息 ， 实 
现 如 下 : 

String INSERT DATA ="INSERT INTO student info (id,name,number) values (1, 

2 欧 过 0) 区 二 

熟悉 了 添加 数据 的 方法 ， 接 下 来 用 这 两 种 方法 向 表 中 添加 数据 ， 代 码 如 下 : 

01 // 添 加 数据 

















02 case R.id.sql add: 
03 mdb = mDbHelper.getWritableDatabase (); 
04 7 使 用 读 写 句柄 来 添加 --------- 
05 ContentValues add cv = new ContentValues () ; 
// 实 例 化 数据 容器 ContentValues 类 
06 add_cv.put ("name",，" 欧 零 "+i+""); // 添 加 学 生 名 
07 add_cv.put ("number"，i+"") ; // 添 加 学 号 
08 mdb.insert("student info", null, add cv); 
// 使 用 数据 库 添加 方法 添加 

09 让 
10 // ---------------------- sql 语句 插入 -=------------- 
11 String INSERT DATA = 
3 "INSERT INTO student info(id,name,number) values (1, ' 欧 零 '， 

和 // 数 据 添加 sql 语句 
13 mdb .execSQL (INSERT DATA); // 执 行 sql 语句 
14 Toast.makeText (context， "成 功 添加 数据 "，1000) .show() 
15 break; 


其 中 ，01 一 03 行 ， 获 得 需要 操作 的 数据 库 。 这 里 使 用 的 是 系统 目录 下 默认 的 数据 库 ; 

04 一 09 行 ， 使 用 数据 库 的 读 写 句柄 来 添加 数据 ;05 一 07 行 ， 将 名 为 “ 欧 零 ”、 学 号 为 1 
的 学 生 信息 保存 在 ContentValues 中 ; 07 行 ， 使 用 insert 方法 将 值 添加 到 表 student_info 中 ; 

08 一 11 行 ， 使 用 sql 语句 添加 数据 。 实 现 效果 如 图 4.22 所 示 。 

3. 删除 学 生 信息 

删除 数据 的 方式 同样 有 两 种 : 

(1) 第 一 种 是 使 用 SQLiteDatabase 提供 的 delete 方法 : 

delete (String table，String whereClause, String[] whereArgs) 

其 中 ， 第 一 个 参数 是 需要 操作 的 表 名 。 第 二 个 参数 为 判断 条 件 ， 如 果 这 里 传 入 null， 
表示 全 部 删除 。 第 三 个 参数 默认 为 null 即 可 。 例 如 ， 删 除 表 student info 中 学 号 为 1 的 学 
生 记 录 ， 实 现 如 下 : 


mdb.delete("student info ™, "number =1", null); 
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(2) 第 二 种 是 用 sql 语句 实现 。 删 除 记录 的 SQL 语句 为 : 

DELETE FROM 表 名 WHERE 条 件 

同样 是 删除 表 student info 中 ， 学 号 为 1 的 学 生 记 录 ，sql 语句 如 下 : 

String DELETE DATA = "DELETE FROM student info WHERE number=1"; 
熟悉 了 删除 数据 的 方法 ， 我 们 使 用 这 两 种 方法 实现 删除 表 中 的 数据 ， 代 码 如 下 : 
01 // 删 除数 据 





02 case R.id.sql delete: 

03 mdb = mDbHelper .getWritableDatabase (); 

04 使 用 读 写 句柄 删除 

05 mdb.delete("student info", "number =1", null); 

06 -=---------------------- sql 语句 删除 

07 String DELETE DATA = "DELETE FROM student _ info WHERE number=1"; 
08 mdb .execSQL (DELETE DATA); 

9 

10 Toast .makeText (context， "成功 删除 数据 "，1000) .show() ; 

11 break; 


其 中 ，05 行 ， 使 用 数据 库 读 写 句 柄 删除 数据 ， 删 除 表 student_info 中 ， 学 号 为 1 的 学 
生 记 录 ; 
07 一 08 行 ， 使 用 sql 语句 删除 数据 ， 同 样 是 删除 表 student_info 中 ， 学 号 为 1 的 学 生 记 
发， 效果 如 图 4.23 所 示 。 
4. 修改 学 生 信 息 


修改 数据 的 方式 同样 有 两 种 : 
(1) 第 一 种 是 使 用 SQLiteDatabase 提供 的 update: 


update (String table, ContentValues values, String whereClause, String[] 
whereArgs) 


其 中 ， 第 一 个 参数 是 需要 操作 的 表 名 ; 第 二 个 参数 是 修改 的 值 ， 第 三 个 参数 为 判断 条 
件 , 如 果 这 里 传 入 null, 表示 全 部 删除 。 第 四 个 参数 默认 为 null 即 可 。 例 如 ,将 表 student_info 
中 ，id 为 3 的 学 生 姓名 修改 为 “示例 大 全 ”， 实 现 如 下 : 

ContentValues temp cv = new ContentValues(); 

edit_cv.put ("name",， "示例 大 全 "); 
mdb.update ("student info", edit cv, "id = 3", null); 

(2) 第 二 是 使 用 sql 语句 实现 。 修 改 记录 的 sql 语句 : 

UPDATE 表 名 SET 修改 内 容 WHERE 修改 条 件 

例如 ， 同 样 是 将 表 student_info 中 ，id 为 3 的 学 生 姓 名 修改 为 “示例 大 全 ”， 实 现 如 下 : 

String UPDATA DATA ="UPDATE student info SET text=' 通 过 SQL 语句 的 示例 大 全 ' 

WHERE id=3"; 

熟悉 了 修改 数据 的 方法 ， 我 们 使 用 这 两 种 方法 实现 修改 表 中 的 数据 ， 代 码 如 下 : 


01 // 修改 数据 
02 case R.id.sql edit: 
03 mdb = mDbHelper.getWritableDatabase(); 


% 
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04 -一 使 用 句柄 方式 修改 一 

05 ContentValues edit cv = new ContentValues(); 

06 edit_cv.pPut("name" ，" 示 例 大 全 ") : 

07 mdb .update ("student info", edit cv, "id = 3", null); 

08 // -===----=--------------- sdl 语句 修改 ------------- 

09 String UPDATA DATA = 

10 "UPDATE student info SET text=' 通 过 SQL 语句 的 示例 大 全 ' WHERE 
id=3"; 

J db.execSQL (UPDATA DATA); 

下 有 Toast .makeText (context， "成 功 修改 数据 "，1000) .show () ; 

13 break; 


其 中 ，05 一 07 行 ， 使 用 数据 库 读 写 句 柄 修改 学 生 信息 ， 将 id 为 3 的 学 生 姓 名 修改 为 
“示例 大 全 ”; 

07 一 08 行 ， 使 用 sql 语句 修改 学 生 信息 
为 3 的 学 生 姓名 修改 为 “通过 sql 语句 的 示例 大 全 ”， 
效果 如 图 4.24 所 示 。 


5. 查询 学 生 信息 





数据 库 查 询 方式 也 有 两 种 : 

(1) 第 一 种 是 使 用 SQLiteDatabase 提供 的 query 
方法 。query 有 多 种 实现 ， 最 常用 的 是 : 

query(String table， String[] columns， 


String selection，String[] selectionArgs, 
String groupBY， String having， String 


orderBy) 
其 中 ， 第 一 个 参数 是 表 名 称 ， 第 二 个 参数 是 列 成 功 修改 数据 


名 称 数 组 ， 第 三 个 参数 是 条 件 子 句 ， 相 当 于 where， 
第 四 个 参数 是 条 件 子 句 ， 参 数 数组 ， 第 五 个 参数 是 


分 组 列 ， 第 六 个 参数 是 分 组 条 件 ， 第 七 个 参数 是 排 
序 方式 。 大 部 分 参数 如 果 没 有 用 到 ， 可 以 为 null。 例 





如 ， 查 询 表 student_info 中 的 所 有 数据 ， 代 码 如 下 : 图 424 修改 数据 
Cursor cu = db.query("student info", projections, null, null, null, 


nullnull)s 


该 方法 返回 值 类 型 为 Cursor。Cursor 是 一 个 游标 接口 ， 每 次 查询 的 结果 都 会 保存 在 
Cursor 中 , 可 以 通过 遍历 Cursor 的 方法 拿 到 当前 查询 到 的 所 有 信息 。 常 用 的 Cursor 方法 有 : 





getCount () // 得 到 Cursor 总 记录 条 数 
getColumnIndex (String columnName) // 根 据 列 名 称 获得 列 索引 ID 
getstring (int columnIndex) // 根 据 索 引 ID 拿 到 表 中 存储 的 字段 
moveToFirst () // 将 Cursor 的 游标 移动 到 第 一 条 
moveToLast () // 将 Cursor 的 游标 移动 到 最 后 一 条 
move (int offset) // 将 cursor 的 游标 移动 到 指定 ID 
moveToNext () // 将 Cursor 的 游标 移动 到 下 一 条 
moveToPrevious () // 将 Cursor 的 游标 移动 到 上 一 条 

















(2) 第 二 种 是 使 用 SQLiteDatabase 提供 的 rawQuery 方法 : 
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却 
NS 


看 了 


rawQuery (String sql, String[] selectionArgs) 

其 中 ， 第 一 个 参数 是 sql 语句 ， 第 二 个 参数 默认 为 null 即 可 。 查 询 记 录 的 sql 语句 为 : 
SELECT 列 名 FROM 表 名 

例如 ， 同 样 是 查询 表 ouling 中 的 所 有 数据 ， 代 码 如 下 : 

Cursor cur = mdb.rawQuery ("SELECT * FROM student info ", null); 
掌握 了 这 两 种 方法 ， 我 们 使 用 这 两 种 方法 实现 遍历 表 中 所 有 记录 ， 代 码 如 下 : 

01 // 遍 历数 据 


02 case R.id.sql qu: 

03 mdb = mDbHelper .getReadableDatabase (); 

04 We 语句 查询 

05 Cursor cur = mdb.rawQuery ("SELECT x* FROM " 

06 + DB helper.TABLE NAME, null); 
9 句柄 查询 

08 String[] projections = new String[] { "id", "name","number" }; 
09 Cursor cur =mdb.query ("student info", projections, null, null, 
10 Rail id danc uy 

2 String temp = ""; 

rd EE (ou = naLly 

| if (cur.getCount() == 0) { 

14 temp = "无 数据 "; 

15 } 

16 while (cur.moveToNext()) {// 直 到 返回 false 说 明 表 到 了 数据 末尾 
17 temp += cur.getSstring(0) + " A 

18 // 参 数 0 指 的 是 projections 数组 列 的 下 标 ， 这 里 的 0 指 的 是 id 列 
19 temp += CuUT .getString(1) ; 

20 // 这 里 的 0 相对 于 当前 应 该 是 name 列 了 

2 temp += cur.getString (2); 

22 // 这 里 的 2 对 应 的 是 number 列 

人 3 temp += "\n™; 

24 } 

E43 } 

26 Toast.makeText (context, temp, 1000) .show(); 

27 break; 


其 中 ，05 一 06 行 ， 使 用 语句 查询 方式 ， 获 得 表 中 所 有 记录 ; 

08 一 10 行 ， 使 用 数据 库 句 柄 查询 方式 ， 获 得 表 中 所 有 记录 ， 并 且 记录 按照 id 值 由 大 
到 小 排列 ， 
12 一 15 行 ， 判 断 游标 是 否 为 空 或 者 查询 结果 为 空 ， 当 为 空 时， 给 出 相应 的 “无 数据 


16~27 行 ， 遍历 游标 ， 获 得 查询 的 结果 。 需 要 注意 的 是 查询 完成 后 ， 游 标 指向 的 位 置 
并 不 是 获得 数据 的 第 一 个 。 需 要 获得 第 一 个 数据 需要 使 用 moveToNext (0 方法， 效果 如 图 
4.25 所 示 。 


6. 运行 分 析 总 结 
对 程序 进行 调试 运行 , 将 系统 目录 下 的 数据 库 OuLing.db 导出 ,使 用 SQLite 数据 库 查 








[ 具 查 看 表 的 内 容 


。 当 直接 添加 3 次 数据 ， 删 除 1 次 数据 后 ， 结 果 如 图 4.25 所 示 ; 当 修 


改 记 录 后 ， 结 果 如 图 人 遍历 表 的 内 容 ， 结 果 如 图 4.27 所 示 。 
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0e or DO 
File Edit View Execute 0ptions Jelp 











Name Type NN PK | 因 园 student_info 
SD nan Di\Documents and:” 
忆 万 Tables (3) | 
由 忆 android_metadata 


























File Edit View Execute Options Jelp 
Name Type NN PK 
BD mn Di:\Documents and: | 

日 蝇 Tables (3) | 
由 罚 android_metadata [ 










表 中 修改 一 条 记录 
坦 询 表 中 所 有 记录 


图 4.27 遍历 所 有 记录 


成 功 实现 了 对 学 生 信息 进行 添加 、 删 除 、 修 改 以 及 查询 操作 ， 我 们 发 现 增删 改 查 这 4 











种 操作 都 有 两 种 方法 : 一 种 是 使 用 SQLiteDatabase 提供 的 数据 库 操作 方法 ; 一 种 是 使 / 








sql 


语句 。 这 两 种 方法 是 没有 本 质 上 的 区 别 的 ， 主 要 看 对 sql 语句 的 熟悉 程度 ， 如 果 熟 悉 sql 


语言 就 采用 sql 语句 的 方式 完成 ， 如 果 不 熟 悉 SQL 语言 可 以 选择 使 用 SQLiteDatabase 
的 数据 库 操作 方法 。 


提供 
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对 整个 数据 库 的 操作 ， 无 论 如 何 都 是 最 先 创建 数据 库 ， 然 后 创建 表 ， 最 后 才能 操作 表 
中 的 记录 。 


4.5 日 记 本 





记 本 作为 记录 自己 经 历 与 心情 的 日 常 工具 ， 大 家 从 小 就 开始 使 用 ， 相 信 大 家 对 此 都 
很 熟悉 ， 这 一 节 我 们 将 实现 Android 的 日 记 本 来 记录 自己 的 阴 晴 雨 雪 。 

回想 一 下 日 记 本 ， 我 们 写 入 的 内 容 是 有 一 定 的 格式 的 ， 一 般 包 括 了 日 期 、 天气、 标题 
以 及 具体 内 容 这 4 点 。 所以, 在 编写 日 记 的 界面 设计 时 , 也 只 需要 设计 这 4 项 内 容 的 输入 。 
而 且 对 于 这 样 有 规律 的 数据 ， 我 们 自然 而 然 想到 使 用 数据 库 来 存储 这 些 信息 。 在 明确 了 这 
些 基 本 内 容 ， 接 下 来 就 是 实现 这 些 功 能 并 不 断 完善 。 





























4.5.1 写 日 记 


1. 界面 设计 


在 写 日 记 时 ， 只 需要 记录 日 期 、 天 气 、 标 题 以 及 具体 的 内 容 ， 所 以 在 界面 设计 时 ， 只 
需要 提供 这 4 项 即 可 ， 如 图 4.28 所 示 。 为 了 提供 更 友好 的 交互 ， 日 期 通过 读 取 系 统 日 期 直 
接 显示 ; 天 气 使 用 ImageSwitcher 效果 来 选择 天 气 ， 如 图 4.29 所 示 。 


ex notes 


2011-08-21 @ 请 选择 天 气 


内 容 





图 4.28 写 日 记 界 面 图 4.29 选择 天 气 


如 图 4.28 所 示 ， 整 体 界面 布局 使 用 线性 布局 ， 从 上 到 下 顺序 地 添加 相应 控件 。 只 是 天 




















气 图 片 和 标题 输入 栏 需要 注意 。 可 以 使 用 相对 布局 来 完成 ， 类 似 上 一 节 中 显示 的 通讯 录 ; 
也 可 以 使 用 多 个 线性 布局 完成 。 下 面 使 用 线性 布局 来 实现 这 部 分 布局 ， 代 码 如 下 : 
01 <ScrollView android:layout weight="4" android:id="@+id/ScrollView1" 
02 android:layout width="fill parent" android:layout height= 


"wrap content™ 
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03 android:scrollbars="vertical"> 
04 <LinearLayout android:layout width="fill parent" 
05 android:layout height="wrap content" android:orientation= 
"vertical"> 
06 <LinearLayout 
07 android:layout width="fill parent" android:layout 
height="wrap Content" 
08 android:paddingTop="10px" android:layout 
marginLeft="10dp" 
09 android:layout marginRight="10dp"> 
10 <ImageButton android:id="@+id/image button" 
I android:1layout width="70dip" android:layout 
height="70dip" 
2 android:src="@drawable/imgl" android:scaleType= 
"centerCrop" /> 
13 <LinearLayout android:layout width="fill _ Parent" 
14 android:layout height="wrap content" android: 
orientation="vertical" 
5 android:layout marginRight="10dp" android:layout 
marginLeft="10dp"> 
16 <TextView android:layout height="wrap content" 
17 android:layout width="wrap content" android: 
text=" 标 题 : " 
18 android:textSize="20dp" /> 
19 <EditText android:id="@+id/diarytitle" 
20 android:layout width="fil1 parent" android: 
layout height="wrap content" 
21 android:scrollbars="vertical" android:hint=" 
标题 " android:gravity="top" 
2 android:layout gravity="center vertical" /> 
23 </LinearLayout> 
24 </LinearLayout> 
25 </ScrollView> 


其 中 ，01 一 03 行 ， 整 体 添加 上 下 移动 的 滑动 条 ， 防 止 内 容 过 多 时 产生 遮挡 ; 

04 一 5 行 ， 为 整个 界面 添加 布局 ， 布 局 方式 为 线性 布局 ; 

06 一 09 行 ， 添 加 一 个 线性 布局 ， 方 式 为 从 左 到 右 的 横向 线性 布局 ， 用 来 添加 图 片 和 
标题 ; 

10 一 12 行 ， 在 横向 线性 布局 中 ， 添 加 图 片 按钮 ， 用 于 选择 天 气 ; 

13 一 15 行 ， 添加 一 个 线性 布局 ， 方式 为 从 上 到 下 的 纵向 线性 布局 ， 用 来 添加 显示 和 输 
入 框 ; 

16 一 18 行 ， 文 件 显示 ， 显 示 标 题 ; 

19 一 22 行 ， 标 题 输入 框 ， 初 始 有 “标题 ”两 字 的 提示 ， 效 果 如 图 4.28 所 示 。 


2. 选择 天 气 


选择 天 气 使 用 Gallery 和 ImageSwitcher 结合 的 方式 来 实现 。 效果 如 图 4.29 所 示 , 可 以 
分 为 3 步 来 实现 : 
第 一 步 ， 定 义 显示 的 布局 ; 
第 二 步 ， 设 置 Gallery 显示 图 片 ; 
第 三 步 ， 设 置 ImageSwitcher 的 图 片 切换 。 
(1) 设置 显示 
本 示例 采用 单 击 图 片 按钮 后 弹出 自 定 义 提示 框 的 方式 来 显示 。 自 定义 提示 框 显示 自 定 
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义 的 布局 视图 ， 本 示例 即 由 一 个 Gallery 以 及 一 个 ImageSwitcher 组 成 。 我 们 使 用 动态 代码 
绘制 一 个 标题 为 “请 选择 天 气 ”、 内 容 为 活动 图 片 、 拥 有 两 个 按钮 的 提示 框 ， 实 现代 码 


如 下 : 


01 
02 
03 
04 


05 
06 
07 
08 


09 
10 


并 
2 


3 
14 
5 
16 
入 汶 
18 


其 中 ，01 一 02 行 ， 实 例 化 一 个 自 定 


AlertDialog imageChooseDialog; // 头 像 选择 对 话 框 
AlertDialog.Builder builder = new AlertDialog.Builder (this); 
builder .setTitle ("请 选择 天 气 ") .setView (imageChooseView) 
.setPositiveButton ("确定 ",， new DialogInterface. 
OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) { 
imageChanged = true; 
previousImagePosition = currentImagePosition; 


// 获 得 选中 的 图 片 编号 
imageButton 
.SetImageResource (images [currentImagePositionsg 
images.length]) // 设 置 天 气 图 


} 
二 setNegativeButton (" 取 消 "new DialogInterface 
.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) { 
currentImagePosition = previousImagePosition; 
L 
Ts 


imageChooseDialog = builder.create(); 


义 提示 框 ; 





03 行 ， 定 义 提示 框 的 标题 为 “请 选择 天 气 ” 以 及 显示 视图 为 imageChooseView。 该 
imageChooseView 视图 便 是 滑动 图 片 的 视图 ， 接 下 来 将 详细 讲解 其 实现 ; 

04 一 11 行 ， 定 义 “ 确 定 ” 按 钮 ， 以 及 单 击 “ 确 定 ”按钮 的 事件 处 理 。 记 录 是 否 选择 改 
变 、 记 录 选 择 的 图 片 编号 并 将 按钮 的 图 片 改变 为 选择 的 图 片 ; 

12 一 17 行 ， 定义 “取消 ”按钮 ， 以 及 单 击 “ 取 消 ”按钮 的 事件 处 理 。 记 录 选 择 的 图 片 


编号 。 


(2) 设置 Gallery 

使 用 Gallery 和 使 用 ListView 一 样 需要 先 实现 自己 的 数据 适配器 。 继 承 自 BaseAdapter， 
实现 其 构造 函数 以 及 getCount0、getItem0、getItemId0 和 getView() 4 种 方法 。getViewO 
用 来 实现 Gallery 的 图 像 绘 制 ， 是 实现 的 重点 。 代 码 如 下 : 


01 
02 
93 


04 
05 


06 
07 


08 
09 
10 
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// Gallery 从 这 个 方法 中 拿 到 image 


@Override 
public View getView(int position, View convertView, ViewGroup 
parent) { 
ImageView iv = new ImageView (context); // 实 例 化 图 像 视图 
iv.setImageResource (images [position % images.length]); 
// 设 置 显 示 图 像 
iv.setAdjustViewBounds (true); // 设 置 边 界 
iv.setLayoutParams (new Gallery.LayoutParams (80, 80)); 
// 设 置 显示 布局 
iv.setPadding (15, 10, 15, 10); // 设 置 边 距 


return iv; 
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其 中 ，04 行 ， 实 例 化 一 个 图 像 视 图 ; 

05 行 ， 设 置 视图 的 图 像 。setImageResource() 参 数 为 图 片 资源 的 id 号 ; 

06 一 08 行 ， 设 置 视图 的 相关 属性 ， 分 别 为 条 件 是 否 为 边界 、 显 示 格 式 以 及 边 距 填充 属性 。 
实现 了 Gallery 的 适配器 后 ， 就 可 以 实现 Gallery 的 数据 关联 以 及 事件 处 理 。 具 体 实 现 


如 下 : 


01 
02 
03 


04 


05 
06 
07 
08 


09 
10 
argl, 
I 
12 
3 
14 
5 
16 
了 了 
18 
9 
20 
21 


LayoutInflater 1i = LayoutInflater.from(Notes add.this); 
imageChooseView = li.inflate(R.layout.choice img, null); 
// 通 过 演 染 XML 文件 ， 得 到 一 个 视图 (View) ， 青 拿 到 这 个 View 里 面 的 
Gallery 

gallery = (Gallery) imageChooseView.findViewById(R.id. 
gallery); 
// 为 Gallery 装载 图 片 
gallery.setAdapter (new ImageAdapter (this)); 
gallery.setSelection (images.length / 2); 
gallery.setOonItemSelectedListener (new 
OnItemSelectedListener() { 

@Override 

public void onItemSelected (AdapterView<?> arg0, View 


int arg2, long arg3) { 
// 当 前 的 头像 位 置 为 选中 的 位 置 
currentImagePosition = arg2; 
// 为 ImageSwitcher 设置 图 像 
is.setImageResource (images[arg2 % images.length]); 


} 


@Override 
public void onNothingSelected (AdapterView<?> arg0) { 
} 

Ds 


其 中 ,01 一 04 行 ， 使 用 inflate 方法 将 布局 转 为 视图 ， 并 从 视图 中 实例 化 Gallery 控件 ; 

05 一 07 行 ，Gallery 与 适配器 关联 获得 显示 内 容 ， 并 初始 化 选择 的 图 片 ; 

08 一 21 行 ， 实 现 Gallery 的 选择 变化 的 处 理 ，13 行 记录 选择 的 图 片 变化 ，15 行 设置 
ImageSwitcher 的 显示 图 片 。 

(3) 设置 InageSwitcher 

设置 ImageSwitcher 需要 设置 其 图 片 切换 时 的 视图 工矿、 加 载 和 外 载 图 片 时 的 动画 效 
果 。 在 ImageSwitcher 中 设置 图 片 切换 的 视图 工厂 ， 使 用 方法 为 : 


public void setFactory (ViewSwitcher.ViewFactory factory) 


其 中 ， 参数 为 切换 的 视图 工厂 。 该 工厂 用 于 在 ViewSwitcher 中 创建 视图 ， 需 要 实现 工 


厂 类 的 方法 : 





View makeView () 


该 方法 就 是 具体 实现 创建 一 个 用 于 添加 到 视图 转换 器 (ViewSwitcher) 中 的 新 视图 。 
本 示例 中 的 makeView0 方 法 实现 如 下 : 


Q@Override 

Public View makeView() { 
ImageView view = new ImageView (this); // 实 例 化 图 像 视图 
View.setBackgroundColor (0xff£f000000); // 设 置 背景 颜色 
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05 View.setScaleType (ScaleType-FIT CENTER) // 设 置 边界 缩放 

06 View.setLayoutParams (new ImageSwitcher.LayoutParams (90, 90)); 
// 设 置 界面 布局 

07 return view; 

08 } 


其 中 ，03 行 ， 实 例 化 一 个 视图 类 ; 

04 行 ， 设 置 视图 的 背景 色 ，0xff000000 为 黑色 ; 

05 行 ,设置 视图 将 图 片 边界 缩放 ， 以 适应 视图 边界 的 可 选项 。 FIT_CENTER 表示 在 视 
图 中 使 图 像 居 中 ， 不 执行 缩放 ; 

06 行 ， 设 置 视图 的 布局 参数 。 

在 ImageSwitcher 中 设置 视图 切换 的 动画 效果 ， 载 入 时 和 务 载 时 的 动画 效果 分 别 使 用 
方法 : 

setInAnimation (Animation inAnimation) 

setOutAnimation (Animation outAnimation) 

其 中 ， 参 数 为 动画 效果 。 定 义 动画 效果 使 用 AnimationUtils 的 方法 : 


loadAnimation(Context context, int id) 


其 中 ， 第 一 个 参数 是 上 下 文 的 环境 ， 第 二 个 参数 是 动画 加 载 的 资源 ID 号 。 系 统 本 身 
提供 了 一 些 动画 效果 在 R.anim 中 。 掌握 了 设置 ImageSwitcher 的 方法 , 具体 实现 代码 如 下 : 


01 ImageSwitcher is;  // 定 义 头像 的 ImageSwitcher 

02 is = (ImageSwitcher) imageChooseView.findViewById(R.id. 
imageswitch) 

03 is.setFactory (this); 

04 // 加 载 图 片 时 的 动画 效果 

05 is.setInAnimation (AnimationUtils.loadAnimation(this, android.R. 


anim.fade in)); 

06 // 季 载 图 片 时 的 动画 效果 

07 is.setOoutAnimation (AnimationUtils.loadAnimation(this, android.R. 
anim.fade out)); 


3. 数据 库 保存 日 记 

通过 上 面 的 界面 设计 ， 接 下 来 实现 使 用 数据 库 对 日 记 内 容 的 保存 。 为 了 保证 日 记 信息 
的 完整 与 统一 ， 添 加 一 个 类 Diary 来 保存 日 记 信 息 ， 分 别 记录 日 记 标题 、 日 记 日 期 、 日 记 
内 容 以 及 天 气 的 图 片 卫 号 ， 代 码 如 下 : 


public class Diary implements Serializable { 


Bublie int ids // 编 号 
public String diarytitle; // 标 题 
public String diarydate; // 日 期 
public String diarycontent; // 内 容 
public int imageId; // 天 气 图 片 编号 


| 


对 于 日 记 的 日 期 ， 默 认 使 用 获得 的 当前 系统 日 期 ， 当 然 也 是 可 以 修改 的 。 系 统 日 期 的 
获得 方法 是 : 
SimpleDateFormat sDateFormat = new SimpleDateFormat ("yyyy-MM-dd"); 


return sDateFormat.format (new java.util.Date()); 
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在 使 用 数据 








新 建 记录 日 记 信 息 的 表 ; 第 三 步 ， 向 表 中 添加 记录 ， 保 存 日 记 。 


(1) 新 建 数 





据 库 


库 来 保存 日 记 ， 对 其 实现 可 以 分 为 3 步 : 第 一 步 ， 新 建 数据 库 ; 第 二 步 ， 


为 了 保证 数据 的 安全 性 ， 将 数据 库 保 存在 系统 目录 中 ， 可 以 使 用 数据 库 的 辅助 类 
SQLiteOpenHelper 来 实现 。 相 信 大 家 已 经 非常 熟悉 这 个 过 程 ， 继 承 SQLiteOpenHelper 类 ， 
并 实现 其 构造 函数 。 具 体 代 码 如 下 : 


01 class MyDBHelper extends SQLiteOpenHelper { 

02 

03 Public MyDBHelper (Context context, String name, int version) { 
04 super (context, name, null, version); 

05 } 

(2) 新 建 日 记 记 录 表 


一 条 日 记 记 录 由 类 Diary 来 记录 ， 所 以 在 日 记 记 录 表 中 ， 同 样 需要 5 列 来 记录 信息 : 
_id 为 主键 、diarytitle 保存 标题 、diarydate 保存 日 期 、diarycontent 保存 内 容 、imageid 保存 
天 气 的 图 片 号 。 在 重 写 SQLiteOpenHelper 类 的 onCreate() 方 法 时 ， 实 现 对 记录 表 的 创建 。 


具体 代码 如 下 : 


01 
02 
03 
04 


05 


06 
07 


@Override 


public 


void onCreate (SQLiteDatabase db) { 


String tableCreate = "create table "+ TABLENAME 
+ " ( id integer primary key autoincrement, 


db 
} 


diarytitle 


text,diarydate text,diarycontent text,imageid int)"; 


// 创 建 sql 语句 
.execSQL (tableCreate); 


其 中 ，03 一 05 行 ， 表 示 创 建 记 录 表 的 sql 语句 ; 
06 行 ， 执 行 sql 语句 ， 创 建 记录 表 。 


(3) 保存 日 
向 数据 库 表 


中 添加 


录 ， 因 为 该 方法 将 返回 


记 信息 





long 值 ， 当 添加 成 功 时 ， 返 





返回 -1。 添 加 记录 的 实现 代码 如 下 : 





记录 ， 有 两 种 方法 ， 下 面 使 用 Android 提供 的 insert0 方 法 来 添加 记 
回 新 插入 行 的 行 ID; 当 发 生 了 错误 时 ， 


// 数 据 容器 
// 保 存 标题 
// 保 存 日 期 
// 保 存 内 容 
// 保 存 图 片 id 


01 public static SQLiteDatabase dbInstance; 

02 // 往 数据 库 里 的 tb_diary 表 添 加 一 条 数据 ， 若 失败 则 返回 -1 

03 Public long insert(Diary diary) { 

04 ContentValues values = new ContentValues () : 

05 values.put ("diarytitle", diary.diarytitle); 

06 values.put ("diarydate", diary.diarydate); 

07 values.put ("diarycontent", diary.diarycontent); 

08 values.put ("imageid", diary.imagelId); 

09 return dbInstance.insert (TABLENAME，null，values); // 添 加 数据 
10 } 


其 中 ，01 行 ， 声 明 一 个 静态 的 SQLiteDatabase 变量 ， 保 证 数据 库 使 用 的 唯一 性 ; 
03 行 ， 定 义 添 加 数据 的 方法 ， 参 数 为 日 记 类 Diary; 

04 一 08 行 ， 通 过 日 记 类 将 需要 保存 的 数据 放 入 ContentValues 中 ; 
09 行 ， 将 记录 保存 到 数据 库 中 。 
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4. 运行 分 析 总 结 


对 程序 进行 调试 运行 ， 天 气 选 择 可 以 如 图 429 所 示 正 常 选 择 。 将 程序 目录 
data/data/com.ouling.ex_notes 下 的 数据 库 文 件 db_notes.db 导出 , 使 用 SQLiteSpy 查看 结果 ， 
如 图 4.30 所 示 ， 与 我 们 输入 的 内 容 是 相同 的 。 

AT 
DID CRERTE TABLE th notes (_id integer primary key autoinorement,diarytitle tey 























) 
园 androd_metadata -一 
机 性 sqjike_sequence 则 diarytitie diarydate darycontent imageid 
由 罚 由 notes 局 天 气 不 错 2011-08-21 雨 后 天 空 ， 水 洗 过 之 后 的 蓝 色 ， 非常 漂亮 。2130837506 
图 430 保存 日 记 


实现 写 日 记 的 功能 , 我 们 使 用 到 了 基本 的 布局 组 合 、Gallery 和 ImageSwitcher 的 使 用 、 
系统 时 间 的 获取 以 及 数据 库 。 


4.5.2 主 界面 
1 功能 说 明 标题 三 天 气 不 钳 


日 期 2011-08-21 


上 面 已 经 实现 了 日 记 本 最 主要 的 功能 一 一 写 日 记 并 
且 保 存 日 记 ， 当 然 还 有 很 多 其 他 功能 需要 实现 。 例 如 日 
记 的 阅读 、 修 改 甚至 删除 。 而 且 对 于 一 款 应 用 来 说 ， 进 
入 程序 就 是 写 日 记 的 界面 ， 显 然 也 是 不 合适 的 。 所 以 需 
要 设计 出 一 个 将 功能 全 部 包括 的 流程 和 主 界面 。 

在 主 界面 中 ,使 用 ListView 将 记录 在 数据 库 中 的 所 
有 日 记 显示 出 其 标题 和 日 期 。 当 选择 ListView 中 某 一 项 
时 ， 跳 转 显 示 该 日 记 的 详细 信息 ， 并 允许 对 日 记 进行 修 
改 。 同 时 ， 主 界面 也 使 用 菜单 来 提供 写 日 记 和 退出 程序 
的 功能 ， 效 果 如 图 4.31 所 示 。 


2. ListView 显 示 











图 4.31 主 界面 


对 于 自 定义 布局 的 ListView 显示 , 我 们 已 经 非常 熟悉 了 : 第 一 步 , 定义 ListView 中 的 
每 一 栏 布 局 ， 第 二 步 ， 实 现 数据 适配器 : 第 三 步 ， 定 义 ListView 的 布局 与 数据 关联 。 

(1) Item 布局 

如 图 4.31 所 示 ，ListView 每 一 栏 的 布局 是 左边 是 一 个 图 片 ， 右 边 两 行文 字 ， 这 样 的 界 
面 布局 不 难 实现 ， 只 是 使 用 白色 的 文字 ， 文 字 颜 色 设置 如 下 : 


android:textColor="#ffffffff" 


(2) 获取 所 有 日 记 
日 记 信 息 保存 在 数据 库 中 ， 只 需要 通过 查询 数据 库 即 可 。 数 据 库 的 查询 有 两 种 方法 ， 
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下 面 通过 Android 提供 的 query0 方 法 来 实现 。 使 用 动态 数组 ArrayList 返回 所 有 的 信息 , 具 
体 实现 如 下 : 
01 // 获 得 数据 库 中 所 有 的 信息 ， 将 每 一 个 用 户 放 到 一 个 map 中 去 ， 然 后 再 将 map 放 到 1ist 里 





02 public ArrayList getAllDiary() { 
03 ArrayList list = new ArrayList(); // 日 记 全 内 容 数组 
04 Cursor cursor = null; 
05 cursor = dbInstance.query (TABLENAME, new String[] { " id", 
06 "diarytitle", "diarydate", "diarycontent", "imageid" }, 
07 null,null，null，null，null) ; ”// 查 询 数据 库 中 的 所 有 日 记 
08 
09 while (cursor.moveToNext()) { // 遍 历 日 记 
10 HashMap item = new HashMap() // 单 个 日 记 内 容 
1 item.put (" id", cursor.getInt (cursor. 

getColumnIndex(" id"))); // 获 取 id 号 
下 2 item.put ("diarytitle", cursor.getString(cursor 
3 .getColumnIndex ("diarytitle"))); // 获 取 标 题 
14 item.put ("diarydate", cursor.getString (Cursor 
15 .getColumnIndex ("diarydate"))); // 获 取 日 期 
16 item.put ("diarycontent", cursor.getString(cursor 
和 .getColumnIndex ("diarycontent"))); // 获 取 内 容 
18 item.put ("imageid", cursor.getInt (cursor 
19 .getColumnIndex ("imageid"))); // 获 取 图 片 id 
20 list.add(item); // 保 存 到 日 记 数组 中 
21 1 
Et cursor.close(); 
CP return list; 
24 } 


其 中 ，01 一 04 行 ， 完 成 定义 函数 、 声 明 变量 等 初始 化 操作 ; 

05 一 08 行 ， 查 询 数 据 库 中 所 有 的 日 记 。 使 用 SQLiteDatabase 提供 的 query 方法 ; 

09 一 19 行 ， 将 查询 的 结果 以 键 值 对 的 方式 保存 在 HashMap 中 ， 保 存 了 日 记 的 ID 号 、 
标题 、 日 期 、 内 容 以 及 图 片 这 号; 

20 一 21 行 ， 将 保存 着 日 记 信息 的 HashMap 添加 到 动态 数组 list 中 ; 

22 一 24 行 ， 读 取 完 所 有 的 日 记 信 息 后 ， 关 闭 游 标 cursor， 返 回 所 有 日 记 记 录 的 动态 数 
组 list。 

(3) ListView 的 设置 

由 于 视图 布局 简单 且 数 据 不 复杂 , 使 用 Android 提供 的 SimpleAdapter 来 作为 数据 适 配 
器 。 它 可 以 将 静态 数据 映射 到 XML 文件 中 定义 好 的 视图 ， 可 以 直接 指定 数据 支持 的 列表 。 
例如 Map 组 成 的 动态 数组 ， 在 ArrayList 中 的 每 个 条 目 对 应 List 中 的 一 行 ，Map 包含 每 行 
对 应 的 详细 信息 。SimpleAdapter 的 构造 函数 如 下 : 


public SimpleAdapter (Context context, List<? extends Map<String, ?>> data, 
int resource, String[] from, int[] to) 


其 中 : 

口 参数 context， 是 关联 SimpleAdapter 运行 着 的 视图 的 上 下 文 。 

口 参数 data， 是 一 个 Map 的 列表 。 在 列表 中 的 每 个 条 目 对 应 列表 中 的 一 行 ， 包 含 所 
有 在 from 中 指定 的 条 目 。 

口 参数 resource， 是 一 个 定义 列表 项 目的 视图 布局 资源 的 唯一 标识 。 布 局 文件 至 少 应 
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包含 所 有 在 参数 to 中 定义 了 的 名 称 。 
口 参数 fom， 是 一 个 将 被 添加 到 Map 上 关联 每 一 个 项 目的 列 名 称 数组 。 
口 参数 to， 是 在 参数 from 显示 列 的 视图 。 在 列表 中 的 视图 与 参数 fom 中 的 值 一 一 

















对 应 。 
使 用 这 样 的 简单 适配器 ， 显 示 所 有 的 日 记 信 息 的 实现 代码 如 下 : 
01 adapter = new SimpleAdapter(this, list, R.layout.list item, 
02 new String[] { "imageid", "diarytitle", "diarydate" }, 
03 new int[] { R.id.diaryimage, R.id.diarytitle, R.id. 
diarydate }); 
04 lv.setAdapter (adapter); // 将 整合 好 的 adapter 交 给 Listview 
05 lv.setCacheColorHint (Color .TRANSPARENT); 


// 设 置 ListView 的 背景 为 透明 


其 中 ，01 一 03 行 ， 实 现 数据 适配器 。list 获取 得 到 所 有 日 记 记 录 。R.layout.list_ item 是 
每 一 栏 的 布局 。new String[] { "imageid", "diarytitle", "diarydate"} 是 list 中 HashMap 中 的 键 
名 ， 表 示 获 取 这 些 键 对 应 的 具体 数据 。new int[] 数 据 是 item 中 定义 的 控件 资源 标识 ; 

04 行 ， 将 实现 的 适配器 设置 为 ListView， 用 于 显示 。 效 果 如 图 4.31 所 示 。 


3. ListView 单 击 事件 


在 列表 中 只 显示 了 日 记 的 简要 信息 ， 如 果 需 要 查看 日 记 的 详细 记录 甚至 对 日 记 进行 修 
改 ， 就 需要 跳 转 到 查看 修改 界面 。 界 面 的 跳 转 即 Activity 切换 ， 首 先 需 要 在 
AndroidManifest xml 文件 中 声明 。 例 如 需要 跳 转 到 名 为 Notes_read 的 Activity， 声 明 如 下 : 


<activity android:name=".Notes read"></activity> 


当 ListView 中 某 一 栏 被 单 击 时 ， 会 调用 方法 来 处 理 单 击 事件 : 

public abstract void onItemClick (AdapterView<?> parent, View view, int 

position, long id) 

其 中 ， 参 数 parent， 是 发 生 单 击 动作 的 AdapterView; 

参数 view， 是 在 AdapterView 中 被 单 击 的 视图 ; 

参数 position， 是 视图 在 adapter 中 的 位 置 ; 

参数 id， 是 被 单 击 元 素 的 行 id。 

通过 设置 ListView 的 单 击 监听 , 用 单 击 处 理 方法 onItemClickO 实 现 功能 。 在 日 记 本 中 ， 
需要 完成 界面 的 跳 转 ， 并 且 将 日 记 信息 数据 传递 到 下 一 个 界面 中 。 具 体 实现 如 下 : 


01 lv.setOonItemClickListener (new OnItemClickListener() { 


02 // 响 应 单 击 事件 ， 但 单 击 某 一 个 选项 时 ， 跳 转 到 用 户 详细 信息 页 面 


03 @Override 

04 Public void onItemClick (AdapterView<?> arg0, View argl, int arg2, 

05 long arg3) { 

06 HashMap item = (HashMap) arg0 .getItemAtPosition(arg2) : 
// 获 取 选 中 日 记 的 数据 

[oh 

08 Intent intent = new Intent(ex notes.this, Notes read.class); 
// 界 面 跳 转 意 图 

09 Diary diary = new Diary(); // 实 例 化 日 记 类 

10 diary. id = Integer.parseInt (String.valueOf (item.get (" id"))); 
// 获 取 日 记 id 
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半生 diary.diarytitle = String.valueOf (item.get ("diarytitle")); 
// 获 取 日 记 标题 

省 之 diary.diarydate = String.valueOf (item.get ("diarydate")); 
// 获 取 日 记 日 期 

3 diary.diarycontent = String.valueOf (item.get ("diarycontent")); 
// 获 取 日 记 内 容 

14 diary.imageld=Integer.valueOf (item.get ("imageid")); 
// 获 取 天 气 图 片 id 

15 intent.putExtra("diary"，diary); ”// 意 图 中 添加 日 记 类 数据 

16 

17 // 将 arg2 作为 请 求 码 传 过 去 用 于 标识 修改 项 的 位 置 

18 startActivityForResult (intent, arg2); 

19 finish(); 

20 } 

21 1}); 


其 中 ，01 一 05 行 ， 设 置 ListView 中 单 击 一 栏 时 的 监听 事件 ; 
06 一 07 行 ， 获 得 被 单 击 栏 所 对 应 的 日 记 记 录 数 据 ; 
08 一 15 行 ， 定 义 跳 转 意图 ， 并 添加 该 日 记 记 录 的 所 有 数据 到 意图 中 ， 以 便 跳 转 到 显示 


界面 时 显示 ; 


16 一 21 行 ， 实 现 界面 跳 转 。 
4. 菜单 设置 


(1) 菜单 界面 
在 界面 中 通过 菜单 键 可 以 弹出 菜单 。 可 以 使 用 静态 的 XML 文件 定义 菜单 布局 ， 也 可 


以 动态 生成 菜单 。 初 始 化 生成 标准 选项 菜单 的 方法 是 : 


public boolean onCreateOptionsMenu (Menu menu) 


其 中 ， 参 数 为 需要 实现 的 菜单 。 具 体 的 菜单 布局 也 在 该 方法 中 实现 。 常 用 的 动态 添加 
中 新 菜单 项 的 方法 : 





title 


public abstract MenuItem add (int groupId， int itemId, int order, 
CharSequence title) 


其 中 ，groupId 是 组 标识 符 ，itemId 是 项 目 id， 必 须 是 唯一 的 ，order 是 该 项 目的 顺序 ; 


是 显示 的 文本 。 例 如 ， 实 现 图 4.31 所 示 的 下 方 的 菜单 ， 代 码 如 下 : 

01 @Override 

02 public boolean onCreateOptionsMenu(Menu menu) { 

03 menu.add(0，INSERT ID，1，" 写 日 记 ") : // 菜 单 中 添加 菜单 栏 
04 menu.add(0,EXIT ID,2," 退 出 ") 

05 return super.onCreateOptionsMenu (menu); 

06 } 


其 中 ，01 一 02 行 ， 重 写实 现 创建 菜单 的 方法 ; 

03 一 04 行 ， 添 加 菜单 中 的 项 。 分 别 添 加 了 “ 写 日 记 ” 和 “退出 ”两 项 。 
(2) 菜单 单 击 处 理 

实现 了 菜单 的 界面 ， 当 选项 菜单 中 的 项 目 被 选中 ， 对 应 的 处 理 调用 方法 : 


onOptionsItemSelected (MenuItem item) 


其 中 ， 参 数 为 选中 的 菜单 项 目 。 
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熟悉 了 菜单 的 单 击 处 理 方法 ， 在 本 示例 中 ， 当 选中 “ 写 日 记 ” 时 ， 跳 转 到 写 日 记 界 面 ; 





当选 中 “退出 ”时 ， 结 束 整 个 程序 。 具 体 实现 如 下 : 
01 Q@Override 
02 Public boolean onOptionsItemSelected (MenuItem item) { 
03 Switch (item.getItemId()) { 
04 case INSERT ID: // 写 日 记 
05 Intent intent = new Intent (this, Notes add.class); 
// 跳 转 到 添加 日 记 界面 意图 
06 ex notes.this.startActivity (intent) ; // 跳 转 
07 finish(); // 结 束 当前 界面 
08 break; 
09 
10 case EXIT ID: // 退 出 程序 
11 finish(); // 结 束 当前 界面 
1 // 结束 进程 
tk android.os.Process.killProcess (android.os.Process .myPid()); 
14 } 
15 return super.onOptionsItemSelected (item); 
16 } 


其 中 ，01 一 02 行 ， 重 写 菜 单单 击 处 理 方法 ; 
04 一 08 行 ， 当 单 击 “ 写 日 记 ” 项 时 ， 跳 转 到 Notes_add 界面 ; 
09 一 14 行 ， 当 单 击 “ 退 出 ”项 时 ， 实 现 结束 该 程序 。 





4.5.3 读 取 修 改 日 记 


1. 功能 说 明 
在 主 界面 中 ， 


实现 了 单 击 一 项 跳 转 到 读 取 日 记 界 面 的 功能 。 下 面 来 实现 跳 转 到 显示 完 


整 日 记 信 息 的 界面 。 由 于 显示 的 信息 都 是 写 日 记 时 的 信息 ， 所 以 在 界面 设计 上 与 写 日记 界 
面 保持 一 致 。 只 是 将 “保存 ”按钮 蔡 换 为 “修改 ”和 “删除 ”按钮 ， 效 果 如 图 4.32 和 图 


4.33 所 示 。 
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图 4.32 读 取 日 记 图 4.33 修改 日 记 
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2. 显示 日 记 


在 主 界面 跳 转 到 显示 详细 信息 界面 时 ， 在 意图 Intent 中 已 经 附带 了 日 记 的 所 有 信息 ， 
只 需要 获得 附带 的 信息 并 显示 即 可 。 实 现 如 下 : 


01 public void onCreate (Bundle savedInstanceState) { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
让 于 
4 
| 


} 


super.onCreate (savedInstanceState) 7 
setContentView(R.layout.read); 


// 获 得 意图 

Intent intent = getIntent(); 

// 从 意图 中 得 到 需要 的 Diary 对 象 

diary = (Diary) intent.getSerializableExtra("diary") 
// 加 载 数据 ， 往 控件 上 赋值 

loadDiaryData(); 

// 设 置 EditText 不 可 编辑 

setEditTextDisable(); 


其 中 ，01 一 03 行 ， 在 活动 Activity 中 创建 函数 onCreate0， 用 来 根据 XML 文件 创建 


视图 ; 


04 一 08 行 ， 获 得 意图 Intent， 并 读 取 信息 到 Diary 类 ; 

09 一 12 行 ， 实现 显示 界面 的 其 他 功能 ， 加 载 显示 数据 和 设置 显示 效果 ， 实 现 效 果 如 图 
4.32 所 示 。 

获得 需要 显示 的 所 有 数据 保存 到 Diary 类 中 , 接 下 来 只 需要 将 日 记 属性 显示 在 界面 中 。 


由 于 只 是 


读 取 日 记 ， 所 以 内 容 不 可 修改 。 为 了 更 明显 地 表示 出 内 容 的 只 读 性 ， 将 所 有 字体 


颜色 设置 为 白色 。 有 具体 实现 如 下 : 


// 获 得 布局 文件 中 的 控件 ， 并 且 根据 传递 过 来 Diary 对 象 对 控件 进行 赋值 
public void loadDiaryData() { 


// 为 控件 赋值 

et diarytitle.setText (diary.diarytitle); 

et diarydate.setText (diary.diarydate); 

et diarycontent.setText (diary.diarycontent); 
imageButton.setImageResource (diary .imageId); 


} 
// 设 置 EditText 为 不 可 用 
private void setEditTextDisable() { 


et diarytitle.setEnabled (false); 
et diarydate.setEnabled(false); 

et diarycontent.setEnabled (false); 
imageButton.setEnabled (false); 
setColorToWhite(); 


} 
// 设 置 显示 的 字体 颜色 为 白色 


private void setColorToWhite() { 


et diarytitle.setTextColor (Color .WHITE); 
et diarydate.setTextColor (Color .WHITE); 
et diarycontent.setTextColor (Color .WHITE); 





其 中 ，01 一 08 行 ， 是 为 界面 中 的 显示 控件 赋值 ， 从 Diary 类 中 读 取 出 各 控件 需要 显示 


的 内 容 ; 
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09 一 16 行 ， 设 置 控件 为 不 可 用 ， 保 证 内 容 为 只 读 ; 

17 一 22 行 ， 将 显示 的 文字 ， 包 括 标题 、 日 期 以 及 内 容 都 设置 为 白色 。 

3. 修改 日 记 

当 需 要 对 日 记 进行 修改 时 ， 单 击 “ 修 改 ” 按 钮 。 在 单 击 后 ， 转 到 修改 状态 。 此 时 ， 各 
个 控件 可 用 ， 文 字 颜 色 变 为 黑色 并 且 将 “修改 ”按钮 变 为 “保存 ”按钮 ， 用 于 保存 修改 。 
具体 实现 如 下 : 

01 “// 为 按钮 添加 监听 类 




















02 btn_save. setOnC1lickListener (new OnClickListener() { 
03 @Override 

04 Public void onClick(View arg0) { 

05 if (!flag) { // 状 态 判 断 , flag 为 true 为 修改 状态 , false 为 查看 
06 btn_save.setText(" 保 存 ") ;  // 设 置 按 钮 显示 为 “保存 ” 
07 setEditTextRble () // 设 置 为 可 编辑 
08 flag = true; // 修 改 状态 

09 } 

10 } 

二 由 1); 

12 ”// 设 置 EditText 为 可 用 状态 

3 private void setEditTextAble() { 

14 et diarytitle.setEnabled (true); 

15 et diarydate.setEnabled(true); 

16 et diarycontent.setEnabled (true); 

7 imageButton.setEnabled (true) : 

18 setColorToBlack (); 

19 } 

20 

21 // 设 置 显示 的 字体 颜色 为 黑色 

22 private void setColorToBlack() { 

23 et diarytitle.setTextColor (Color.BLACK); 

24 et diarydate.setTextColor (Color .BLACK); 

25 et diarycontent.setTextColor (Color .BLACK); 

26 和 


其 中 ，01 一 03 行 ， 添 加 按钮 的 单 击 监听 事件 处 理 ; 

04 一 08 行 ,完成 对 单 击 事件 的 具体 处 理 。flag 作为 是 否 修改 的 标识 , 修改 状态 时 为 tue， 
读 取 状态 为 false。07 行 用 于 改变 控件 的 使 用 和 位 置 的 颜色 ; 

12 一 19 行 ， 设 置 控件 可 用 ， 保 证 可 以 正常 修改 所 有 内 容 

20 一 26 行 ， 设 置 显示 的 文字 颜色 为 黑色 ， 效 果 如 图 4.33 所 示 。 

当然 ， 在 修改 控件 为 可 用 状态 后 ， 同 样 需要 实现 对 各 个 控件 的 单 击 等 事件 处 理 。 最 主 
要 的 是 实现 对 选择 天 气 的 处 理 。 当 然 ， 效 果 和 写 日 记 时 是 一 样 ， 实 现 也 是 一 样 的 ， 分 为 3 
步 : 第 一 步 , 定义 显示 的 布局 ; 第 二 步 , 设置 Gallery 显示 图 片 ; 第 三 步 , 设置 ImageSwitcher 
的 图 片 切换 。 


4. 保存 修改 


以 上 实现 了 日 记 内 容 的 可 修改 ， 对 已 有 日 记 的 标题 修改 为 “修改 一 下 ”， 如 图 4.33 所 
示 。 完 成 修改 后 ， 需 要 保存 修改 后 的 内 容 到 数据 库 中 。 首 先 对 “保存 ”按钮 ， 即 之 前 的 “ 修 
改 ” 按 钮 ， 添 加 保存 内 容 的 处 理 ， 实 现 如 下 : 
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其 中 ，01 行 ， 是 对 flag 判断 为 tue 时 ， 执 行 以 下 处 理 ; 
02 一 05 行 ， 修 改 数据 库 中 的 记录 ， 失 败 时 返回 ; 


else { 
// 往 数据 库 里 面 修改 数据 
if (modify() == -1) { 
return; 
} 


| 


flag = false; 
setTitle ("修改 成 功 "); 
returnMain(); 





06 一 08 行 ， 修 改 成 功 后 的 处 理 ， 设 置 标识 flag、 提 示 “ 修 改 成 功 ” 以 及 返回 到 主 界面 。 
具体 实现 对 数据 库 的 修改 ， 在 modify0 函 数 中 完成 。 该 函数 实现 对 控件 修改 后 内 容 是 


和 否 为 气 





4 判断 。 当 都 不 为 空 











时 ， 将 修改 后 的 日 记 记 录 保 存 到 Diary 类 中 ， 然 后 修改 数据 库 


的 内 容 。 对 数据 库 进行 修改 时 ， 传 入 参数 为 Diary 类 ， 使 用 SQLiteDatabase 提供 的 update 
方法 。 具 体 实现 如 下 : 

// 修 改 信息 

public void moqdify(Diary diary) { 


ContentValues values = new ContentValues () : 
values.put ("diarytitle", diary.diarytitle); 


10 


其 中 ，01 一 02 行 ， 定 义 数 据 库 修改 函数 ， 参 数 为 Diary 


values.put ("diarydate", diary.diarydate); 


values.put ("diarycontent", diary.diarycontent); 


values.put ("imageid", diary.imagelId); 


dbInstance.update (TABLENAME, values, " id="+String.valueOf 


(diary. id), null); 


03 一 07 行 ， 设 置 数据 库 中 需要 修改 的 内 容 ; 


08 一 09 行 ， 对 数据 库 进行 修改 。 修 改 的 是 id 号 为 传 入 


的 Diary 类 的 id 号 的 记录 。 


5. 删除 日 记 


对 日 记 的 修改 当然 包括 删除 操作 。 下 面 ， 实 现 对 日 记 的 


删除 。 为 了 避免 击 了 “删除 ”按钮 ， 添 加 一 个 提示 ， 


错误 





实现 效果 如 图 4.34 所 示 。 


只 需要 一 个 最 基本 的 提示 框 ， 便 可 完成 该 功能 ， 具 体 实 


现代 码 如 下 : 
ol 


02 
03 
04 
05 


06 


btn delete.setOnClickListener (new 
OnClickListener() { 


@Override 
public void onClick(View v) { 





图 4.34 删除 日 记 


new AlertDialog.Builder (Notes read.this) // 实 例 化 提示 框 
.setPositiveButton ("确定 " , new DialogInterface. 


OnClickListener() { 
Q@Override 


人 
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07 public void onClick(DialogInterface dialog, int 
which) { //“ 确 定 ” 按 钮 的 处 理 

08 delete() : // 调 用 删除 方法 

09 returnMain () // 调 用 返回 主 界面 方法 

10 } 

1 }) .setNegativeButton (" 取 消 " ,new DialogInterface. 

OnClickListener() { 

4 @Override 

3 public void onClick(DialogInterface dialog, int 
which) { 

14 } 

15 }) .setTitle ("是 否 要 删除 ?") .create() .show(); 

16 . 

17 I 


其 中 ，01 一 03 行 ， 添 加 按钮 的 单 击 监听 事件 处 理 ; 
04 行 ， 实 例 化 一 个 提示 框 AlertDialog; 
05 一 10 行 ， 设 置 提示 框 的 “确定 ”按钮 ， 并 实现 单 击 后 的 数据 库 中 删除 记录 和 返 





瑟 


主 


界面 ; 


11~~14 行 ， 设置 提示 框 的 “取消 ”按钮 ; 

15 行 ， 设 置 提示 框 的 标题 。 

实现 了 删除 操作 ， 在 界面 的 提示 后 ， 就 完成 对 数据 库 记 录 的 删除 。 传 入 一 个 日 记 的 id 
使 用 SQLiteDatabase 提供 的 方法 delete0 来 实现 ， 具 体 实现 如 下 : 

// 删除 


public void delete(int _id) { 
dbInstance.delete (TABLENAME, " id=?"+ id, null); 


} 
6. 运行 分 析 总 结 

对 程序 进行 调试 运行 ， 无 论 是 在 显示 日 记 详 细 记 录 、 修 改 日 记 还 是 删除 日 记 时 ， 界 面 
都 可 以 直观 地 看 到 效果 。 当 修改 完成 后 ， 主 界面 中 显示 的 概要 信息 同样 是 更 改 之 后 的 ， 如 
图 4.35 所 示 。 


Emotes 





图 4.35 修改 后 界面 跳 转 
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修改 日 记 之 后 数据 库 保存 的 信息 如 图 4.36 所 示 , 可 以 清楚 看 出 标题 信息 已 经 进行 了 更 
新 。 在 对 日 记 的 修改 过 程 中 ， 使 用 了 对 控件 的 是 否 可 用 、 文 字 的 颜色 等 多 种 属性 的 设置 ， 
以 及 对 数据 库 的 更 新 、 删 除 等 操作 。 

SO DD DEROWOEP ETTDOEESRITD 
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图 4.36 修改 后 的 数据 库 


4.5.4 日 记 本 小 结 


通过 上 面 的 操作 ， 我 们 实现 了 一 个 完整 的 日 记 本 程序 ， 功 能 上 实现 了 日 记 的 添加 、 读 
取 、 修 改 、 删 除 等 操作 ， 界 面 上 对 不 同 功能 的 跳 转 清晰 流畅 。 在 实现 日 记 本 程序 中 ， 我 们 
应 用 到 了 按钮 、 图 片 、 输 入 框 、 提 示 框 等 基本 控件 ， 也 使 用 了 Gallery 和 ImageSwitcher 等 
更 灵活 的 控件 ;使 用 了 不 同 活动 Activity 的 切换 ， 更 使 用 到 了 数据 库 来 保存 数据 。 对 于 这 
样 一 个 实用 的 入 门 实例 ， 希 望 大 家 能 够 很 好 地 理解 整个 过 程 并 且 动手 实现 。 

而 且 对 于 这 样 一 个 实例 ， 一 般 都 会 将 其 中 的 所 有 数据 库 相 关 操 作 封 装 到 一 个 类 中 以 方 
便 人 使用。 例如， 日记 本 中 使 用 到 的 数据 库 的 创建 、 表 的 创建 ， 以 及 日 记 记 录 的 全 部 获取 、 
部 分 获取 、 添 加 日 记 、 更 新 日 记 、 根 据 id 号 删除 日 记 等 操作 ， 将 其 放 入 一 个 类 DBHelper 
中 。 这 样 的 一 个 类 虽然 不 完全 具有 通用 性 , 但 是 只 需要 对 数据 库 名 称 、 创建 表 的 具体 列 名 、 
记录 操作 的 具体 实现 等 细节 进行 修改 ， 便 可 以 适用 于 其 他 程序 。 

当然 ， 这 个 日 记 本 还 有 其 他 可 以 完善 的 地 方 。 例 如 ， 为 了 更 加 安全 ， 添 加 一 个 加 密 功 
能 。 在 开启 程序 时 需要 输入 正确 的 密码 才能 查看 日 记 ， 这 个 密码 可 以 使 用 4.2 节 的 Shared- 
Preference 来 记录 。 


4.6 网 络 存 储 


网 络 是 我 们 现在 获取 信息 的 重要 来 源 , 拥有 最 多 的 数据 量 。 我 们 通过 网 络 来 获取 信息 ， 
同时 也 使 用 网 络 来 保存 数据 。 使 用 网 络 来 存储 的 方式 有 很 多 ， 如 数据 上 传 到 服务 器 、 数 据 
上 传 到 网 盘 、 以 附件 的 方式 保存 在 邮件 中 等 等 。 本 节 中 ， 将 使 用 调用 系统 邮件 程序 来 发 送 
邮件 的 方式 实现 保存 数据 。 





4.6.1 系统 邮件 设置 





要 使 用 系统 邮件 程序 来 发 送 邮件 ， 首 先 需 要 设置 好 邮件 账户 。 我 们 通过 以 下 几 步 来 设 
置 邮件 账户 : 
(1) 在 主 菜单 中 ， 选 择 Email， 如 图 4.37 所 示 。 


a 
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(2) 在 Email 程序 中 ， 根 据 提示 ， 输 入 邮件 地 址 和 密码 。 邮 箱 最 好 使 用 Gmail 的 邮箱 ， 
如 图 4.38 所 示 。 

(3) 单 击 Next 按钮 ， 程 序 将 自动 配置 、 检 查 邮 箱 的 相关 信息 ; 

(4) 完成 自动 配置 、 检 查 后 ， 输 入 邮件 名 称 等 信息 ， 系 统 邮 件 即 设置 成 功 。 
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到 


Set up email 





You can configure Email for most 
acCounts in just a few steps. 


ouling00@gmail.com 


Send email from this account by 
default 


Manual setup 





图 4.37 Email 程序 图 4.38 邮箱 设置 


4.6.2 发送 邮件 


设置 系统 邮件 成 功 后 ， 我 们 通过 程序 调用 系统 邮件 来 发 送 邮件 即 可 。 在 发 送 邮件 程序 
中 ， 需 要 输入 邮件 发 送 到 的 地 址 以 及 邮件 的 内 容 ， 如 图 4.39 所 示 。 


ET 本 22:08 


Ex sendemail 


ouling00@126.com 


网 络 存储 -发 送 邮件 





图 4.39 发 送 邮件 
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当 获 得 了 邮件 的 地 址 和 内 容 后 ， 通 过 意图 Intent 跳 转 到 Email 程序 ， 并 且 携 带 发 送 的 
邮件 地 址 、 邮 件 内 容 、 主 题 、 附 件 等 信息 。 

该 自 定义 的 Intent, 其 动作 为 android.content Intent ACTION SEND, 用 来 跳 转 到 Email 
程序 的 发 送 界面 。 在 Intent 中 ， 还 必须 携带 上 邮件 的 相关 信息 ， 其 中 ， 使 用 setType0 来 决 
定 Email 的 格式 ; 使 用 putExtra0 来 保存 收 件 人 地 址 (EXTRA EMAILL ) 、 主 题 
(CEXTRA_SUBJECT) 、 邮 件 内 容 (EXTRA_TEXT) 、 邮 件 附件 (EXTRA _STREAM) 以 
及 其 他 Email 的 字段 (EXTRA_BCC、EXTRA_CC) 。 了 解 了 邮件 如 何 设 置 其 相关 信息 ， 
具体 的 实现 如 下 : 





01 Intent intent = new Intent(Intent.ACTION SEND); 
02 intent.putExtra (android.content.Intent.EXTRA EMAIL, address); 
// 收 件 人 地 址 
03 intent.putExtra (android.content.Intent.EXTRA TEXT, content); 
// 正 文 
04 File file = new File("/sdcard/Justin Bieber-Baby .mp3"); 
// 附 件 文件 地 址 
05 intent.putExtra (android.content.Intent.EXTRA SUBJECT, 
file.getName ()); // 主 题 
06 intent.putExtra(Intent .EXTRA STREAM，Uri.fromFile (file)) 
// 添 加 附件 , 附件 为 file 对 象 
07 if (file.getName() .endsWith(".gz")) { 
08 intent.setType ("application/x-gzip"); // 如 果 是 gz 使 用 gzip 的 
mime 
09 } else if (file.getName() .endsWith(".txt")) { 
10 intent.setType ("text/plain");  // 纯 文本 则 用 text/plain 的 mime 
EU I elseor 
上 intent.setType ("application/octet-stream"); 
// 其 他 的 均 使 用 流 当 作 二 进 制 数据 来 发 送 
2&3 
14 a (Intent.createChooser (intent, "Email Client")); 


// 调 用 系统 的 mail 客户 端 进行 发 送 
其 中 ,01 行 ,定义 跳 转 到 Email 程序 的 动作 意图 Intent; 


02 行 ， 在 Intent 中 添加 收 件 人 地 址 ; 
03 行 ， 在 Intent 中 添加 邮件 正文 内 容 ; sn IePe BSDY. OP 二 
04 行 ， 获 得 附件 文件 ; 
05 行 ， 在 Intent 中 添加 邮件 的 主题 ， 主 题名 为 附件 的 Justin Bieber-Baby.mp3 

文件 名 ; (ustin BieberBaby.mp3 ] x 





06 行 ， 在 Intent 中 添加 邮件 的 附件 ; 网 络 存储 -发 送 邮件 

07 一 13 行 ， 根 据 附件 的 不 同类 型 来 确定 邮件 的 格式 ; 

14 行 ， 实 现 跳 转 。 如 果 成 功 ， 则 会 跳 转 到 发 送 Email 
的 界面 ， 并 且 Email 的 所 有 内 容 已 经 填写 正确 ， 如 图 4.40 
所 示 。 





4.6.3 运行 分 析 总 结 


以 上 就 实现 了 邮件 的 发 送 。 打 开 收 件 人 邮箱 ， 查 看 收 。 图 440 号 转 到 系统 邮件 界面 
到 的 邮件 ， 有 一 封 来 自 Gmail 的 邮件 ， 如 图 441 所 示 。 在 图 4.41 中 可 以 看 出 ， 邮 件 的 内 
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容 、 主 题 以 及 附件 都 是 正确 的 ， 这 样 我 们 就 通过 邮件 实现 了 网 络 存储 。 
网 易 免费 邮 ouling00@126.com ~ [首页 | 执 肤 | 实验 室 wew | 游戏 直通 村 ] 
6% BT 












区 加 | 回复 | 加 各 全 部 |~ | 转发 |~ | | 删除 | 举报 # 





Justin Bieber-Baby.mp3  T- 避 日 芝 总 于 
发 件 人 : ouling ouling <ouIng00@gmai,com>; 

时 间 : 2011 年 09 月 18 日 22:46 (星期 日 ) 

收 件 人 : oulng00@l126.com; 

附 件 : 1 个 ( 山 ]Justin Bieber-Baby.mp3 ) 查看 附件 





网 络 存 储 -发 送 邮件 





图 4.41 收 件 人 邮件 


由 于 在 模拟 器 的 原因 ，Email 程序 在 发 送出 数据 后 ， 很 可 能 模拟 器 上 会 提示 No 
Application can perform this action， 所 以 ， 和 希望 大 家 使 用 真 机 进行 测试 。 

使 用 系统 邮件 程序 来 发 送 邮件 只 是 网 络 存储 中 非常 简单 的 功能 ， 在 下 一 章 中 ， 我 们 将 
详细 讲述 网 络 通信 的 相关 知识 。 


47 数据 共享 


在 Android 中 的 数据 ， 并 不 是 仅仅 只 能 够 提供 给 创建 该 数据 的 应 用 程序 自己 使 用 ， 同 
样 也 可 以 将 数据 暴露 到 外 界 ， 供 其 他 应 用 程序 使 用 。 这 样 可 以 减少 系统 中 数据 的 元 余 ， 达 
到 应 用 程序 之 间 数 据 的 共享 。 关 于 数据 共享 ， 之 前 学 习 过 文件 操作 模式 ， 知 道 通 过 指定 文 
件 的 操作 模式 为 ContextMODE WORLD READABLE 或 ContextMODE WORLD_ 
WRITEABLE 可 以 实现 对 外 共享 数据 。 

但 是 ， 采 用 这 种 方式 ， 数 据 的 访问 方式 会 因数 据 存储 的 方式 而 不 同 ， 导 致 数据 的 访问 
方式 无 法 统一 。 例 如 ， 采 用 XML 文件 对 外 共享 数据 ， 需 要 进行 XML 解析 才能 读 取 数 据 ; 
采用 sharedpreferences 共享 数据 , 需要 使 用 sharedpreferences API 读 取 数据 .所 以 在 Android 
中 ， 实 现 应 用 程序 间 数 据 共享 的 最 常用 也 最 标准 方式 是 使 用 内 容 提 供 者 (ContentProvider) 
来 实现 。 

这 种 方式 分 为 内 容 提 供 者 (ContentProvider) 和 内 容 解析 器 (ContentResolver) 两 部 分 
实现 。 其 中 ContentProvider 负责 组 织 应 用 程序 的 数据 并 向 其 他 应 用 程序 提供 数据 ; 
ContentResolver 则 负责 获取 ContentProvider 提供 的 数据 以 及 进行 数据 的 添加 、 删 除 、 修 改 、 
查询 数据 等 操作 。 下 面 通过 自 定 义 的 ContentProvider 在 两 个 应 用 程序 之 间 实 现 图 书信 息 的 
数据 共享 来 详细 讲解 ContentProvider。 其 中 使 用 程序 ex_contentprovider 来 提供 数据 ， 
ex_test_myprovider 来 操作 数据 。 





4.7.1 共享 的 图 书信 息 


本 示例 中 ， 将 在 应 用 程序 之 间 共 享 图 书信 息 。 图 书信 息 包括 图 书 名 称 、 图 书 的 ISBN 
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编号 以 及 作者 名 。 这 些 信息 以 数据 库 中 表 的 形式 保存 。 创 建 一 个 books.db 的 数据 库 ， 其 中 
使 用 books 的 表 来 记录 图 书信 息 。 数 据 库 辅助 类 ， 我 们 已 经 多 次 使 用 ， 大 家 比较 熟悉 ， 此 
处 不 再 讲述 。 其 中 创建 表 的 代码 如 下 : 


01 Public class DB helper extends SQLiteOpenHelper { 

02 Q@Override 

03 public void onCreate (SQLiteDatabase db) { 

04 String sql = "CREATE TABLE " + Bookinfo.TABLE NAME + " (" 

05 + Bookinfo. ID + " INTEGER PRIMARY KEY 
AUTOINCREMENT," 

06 +Bookinfo.BOOK NAME +" TEXT," + Bookinfo.BOOK ISBN 
二 

07 + Bookinfo.BOOK RUTHOR + " TEXT) 7 "7 

// 创 建 表 的 sql 语句 

08 db.execSQL (sql); // 执 行 sql 语句 

09 } 

10 } 


其 中 ，01 行 ， 继 承 SQLiteOpenHelper 类 ， 用 于 数据 库 的 管理 ; 
03 一 09 行 ， 创 建 books 表 。 表 中 包括 id、 书 名 、 图 书 ISBN 编号 和 图 书 作者 信息 。 


4.7.2 内 容 提供 者 〈ContentProvider) 


为 了 提供 的 数据 方便 其 他 应 用 程序 共享 ，ContentProvider 以 类 似 数 据 库 中 表 的 方式 将 
数据 暴露 。 外 界 也 通过 这 一 套 标 准 统一 的 接口 共享 这 个 程序 里 的 数据 。 实 现 自 定义 的 
ContentProvider 通过 如 下 3 步 : 

(1) 定义 URI。 

(2) 继承 ContentProvider 类 ， 重 写 其 方法 。 

(3) 在 AndroidManifest 文件 中 ， 对 该 ContentProvider 进行 配置 。 


1. 定义 URI 





要 使 用 URI， 需 要 先 理解 URI 的 意义 和 格式 。URI 代表 了 要 操作 的 数据 ， 一 个 URI 
由 名 称 (scheme) 、 主 机 名 和 路 径 3 部 分 组 成 ， 如 图 4.42 所 示 。 


content:// com.ouling.bookinfo_provider /books/10 


J 1 | 
scheme 主机 名 或 authority 路 径 十 
ID 





其 中 : 

口 scheme 已 经 由 Android 规定 为 content://。 

口 主机 名 (或 叫 Authority) 用 于 唯一 标识 这 个 ContentProvider， 外 部 调用 者 可 以 根 
据 这 个 标识 来 找到 该 ContentProvider。 

口 路 径 (path) 可 以 用 来 表示 我 们 要 操作 的 数据 。 如 图 4.42 所 示 的 路 径 表 示 books 
表 中 id 为 10 的 记录 。 

理解 了 URI 代表 数据 的 格式 ， 在 外 部 调用 传 入 URI 地 址 时 ， 在 ContentProvider 中 ， 
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需要 对 URI 格式 进行 解析 ， 使 用 UriMatcher 类 来 解析 URI 地址 。 使 用 UriMatcher 来 解析 ， 
首先 需要 将 要 匹配 的 URI 路 径 全 部 注册 到 UriMatcher 中 ， 使 用 如 下 方法 来 注册 : 


addURI (String authority, String path, int code) 





其 中 , 第 一 个 参数 代表 传 入 标识 ContentProvider 的 AUTHORITY 字符 串 ; 第 二 个 参数 
是 要 匹配 的 路 径 ， 使 用 “#” 代 表 任 意 数 字 ， 用 “*” 来 匹配 任意 文本 ; 第 三 个 参数 必须 传 
入 一 个 大 于 零 的 匹配 码 ， 用 match0 方 法 对 相 匹 配 的 URI 返回 对 应 的 匹配 码 。 

本 示例 中 ， 用 表 中 id 作为 主键 来 标识 记录 。 注 册 添 加 URI 的 代码 如 下 : 














01 Private static UriMatcher sUriMatcher = null; 

02 private static final int BOOKS RECORDS = 1; // 多 条 记录 

03 private static final int BOOK RECORD = 2; // 单条 记录 

04 static { 

05 sUriMatcher = new UriMatcher (UriMatcher .NO MATCH); 

06 sUriMatcher.addURI (Bookinfo provider.AUTHORITY, "books", 
BOOKS RECORDS); 

07 sUriMatcher .addURI (Bookinfo provider .AUTHORITY, "books/#", 


BOOK RECORD); 
08 } 


其 中 ，01 一 03 行 ， 定 义 、 初 始 化 需要 用 到 的 变量 ; 

05 行 ， 初 始 化 UriMatcher， 添 加 常量 UriMatcherNO_MATCH， 表 示 不 匹配 任何 路 径 
的 返回 码 ; 

06 行 ， 添加 匹配 的 URI 地址 。 当 地址 为 content:// com.ouling.bookinfo_provoider/books 
时 ， 匹 配 返 回 码 为 BOOKS_ RECORDS， 即 1; 

07 行 , 添加 匹配 的 URI 地 址 。 当 地址 为 content:// com.ouling.bookinfo_provoider/books/ 
任意 数字 时 ， 匹 配 返 回 码 为 BOOK_RECORD， 即 2。 

解析 的 地 址 全 部 注册 后 ， 使 用 如 下 方法 来 匹配 URI 地 址 : 


match (Uri uri) 
该 方法 返回 URI 地 址 的 返回 码 。 
2. 继承 ContentProvider 类 


由 于 ContentProvider 以 类 似 数据 库 中 表 的 方式 将 数据 暴露 ， 所 以 在 继承 了 
ContentProvider 类 后 ， 需 要 重 写实 现 的 方法 和 操作 数据 库 的 方法 ， 类 似 添加 〈insert) 、 删 
除 (delete) 、 查 询 (query) 、 修 改 (update) 等 。 除 了 数据 操作 相关 的 方法 外 ， 还 有 类 的 
初始 化 和 处 理 数 据 的 MIME 类 型 。 具 体 需 要 重 写 的 方法 如 下 : 


public class PersonContentProvider extends ContentProvider{ 

public boolean onCreate () 

public Uri insert (Uri uri, ContentValues values) 

public int delete(Uri uri, String selection, String[] selectionArgs) 

public int update (Uri uri, ContentValues values, String selection, String[] 
selectionArgs) 

public Cursor query(Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) 

public String getType (Uri uri) 
|}: 


下 面 ， 通 过 对 图 书信 息 的 共享 来 具体 讲解 这 些 方 法 的 实现 。 
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3，onCreate() 方 法 


当 ContentProvider 启动 时 都 会 回调 onCreate0 方 法 。 该 方法 主要 执行 一 些 
ContentProvider 初始 化 的 工作 ， 返 回 true 表示 初始 化 成 功 ， 返 回 false 则 初始 化 失败 。 本 示 
例 中 ， 该 方法 完成 对 图 书信 息 数 据 库 辅助 类 的 初始 化 ， 具 体 实现 如 下 : 


01 
02 
03 
04 
05 











@Override 

public boolean onCreate() { 
dbhelper = new DB helper (this.getContext ()); 
return true; 


} 


其 中 ，03 行 ， 是 对 图 书信 息 数据 库 辅助 类 DB_helper 的 初始 化 。 
4. getType(Uri uri) 方 法 





该 方法 返回 数据 的 MIME 类 型 。 使 用 UriMatcher 类 对 URI 进行 匹配 ， 并 返回 相应 的 
MIME 类 型 字符 串 。 如 果 操 作 的 数据 属于 集合 类 型 ， 那 么 MIME 类 型 字符 串 应 该 以 
vnd.android.cursor.dir/ 开 头 ; 如 果 要 操作 的 数据 属于 非 集合 类 型 数据 , 那么 MIME 类 型 字符 
串 应 该 以 vnd.android.cursoritem/ 开 头 。 本 示例 中 ， 实 现 如 下 : 


01 
02 


03 
04 


05 
06 
07 
08 
09 
10 
了 
12 
于 3 
14 
下 5 
16 





// 多 记录 ， 数 据 集 的 MIME 类 型 字符 串 应 该 以 vnd.android.cursor.dir/ 开 头 
public static final String CONTENT TYPE = "vnd.android.cursor.dir/ 
vnd.androidbook.book"; 
// 单 记录 ， 单 一 数据 的 MIME 类 型 字符 串 应 该 以 vnd.android.cursor.item/ 开 头 
public static final String CONTENT ITEM TYPE = "vnd.android.cursor. 
item/vnd.androidbook.book"; 
@Override 
public String getType (Uri uri) { 
// TODO Auto-generated method stub 
switch (sUriMatcher.match(uri)) { 
case BOOKS RECORDS: 
return Bookinfo.CONTENT TYPE; // 返 回 图 书信 息 集合 类 型 
case BOOK RECORD: 
return Bookinfo.CONTENT ITEM TYPE; // 返 回 单条 图 书信 息 类 型 
default: 
throw new IllegalArgumentException("Unknown URI " + uri); 
} 
} 


其 中 ，01 一 04 行 ， 定 义 集合 类 型 和 非 集合 类 型 的 MIME 类 型 字符 串 ， 


06~15 


行 ， 根 据 URI 地 址 匹配 的 结果 ， 返 回 相 应 的 MIME 类 型 字符 串 。 





5. insert(Uri uri, ContentValues values) 方 法 




















该 方法 用 于 对 URI 地 址 添加 数据 ， 返 回 值 为 新 添加 数据 的 URI。 在 本 示例 中 ， 为 了 保 
证 添加 数据 的 有 效 性 ， 对 添加 的 数据 进行 检查 ， 如 果 值 为 空 ， 则 补 为 Unknown。 具 体 实 现 
如 下 : 

01 @Override 

02 Public Uri insert(Uri uri, ContentValues values) { 

03 if (sUriMatcher.match(uri) != BOOKS RECORDS) { 

// 不 是 图 书信 息 时 , 抛 出 异常 
04 throw new IllegalArgumentException ("Unknown URI "+ uri); 
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05 
06 


07 


08 
09 


10 
让 
12 


3 
14 
LS 
16 
17 


18 
生生 
20 
2 
22 


2 
24 
25 
26 
ES 


1 
if (values.containsKey (Bookinfo.BOOK NAME) == false) { 

// 无 图 书 名 则 抛 出 异常 
throw new SQLException ("Failed to insert,please input Book 
Name" + uri); 

| 
if (values.containsKey (Bookinfo.BOOK ISBN) == false) { 

// 无 ISBN 号 则 添加 Unknown 

values.put (Bookinfo.BOOK ISBN, "Unknown ISBN"); 
} 
if (values.containsKey (Bookinfo.BOOK AUTHOR) == false) { 

// 无 作者 则 添加 Unknown 

values.put (Bookinfo.BOOK AUTHOR, "Unknown author") 7 
Ls 


SQLiteDatabase db = dbhelper.getWritableDatabase(); 
long rowID = db.insert (Bookinfo.TABLE NAME, Bookinfo.BOOK NAME, 
values); 
// 得 到 记录 的 行 号 ， 主 键 为 int， 实 际 上 就 是 主键 值 
EF (TOWED > ON 
Uri insertBookedUri = ContentUris.withAppendedId!( 


Bookinfo.CONTENT URI, rowID); / /数据库 添加 数据 
getContext () .getContentResolver () .notifyChange 
(insertBookedUri ,null); // 数 据 已 改变 


return insertBookedUri; 


} 


throw new SQLException ("Failed to insert row into " + uri); 


有 


其 中 ，03 一 15 行 ， 对 URI 地 址 以 及 添加 的 数据 进行 检查 ， 当 空 值 时 添加 一 个 默认 值 ; 

16 一 17 行 ， 当 添加 数据 时 ， 完 成 在 ContentProvider 中 的 具体 添加 数据 的 实现 。 在 本 示 
例 中 ， 由 于 操作 的 是 数据 库 ， 就 使 用 数据 库 的 添加 方法 。 如 果 ContentProvider 中 操作 的 是 
XML 文件 ， 则 使 用 XML 文件 的 添加 方式 来 添加 数据 values; 

19 一 22 行 ， 添 加 变化 后 的 URI 地 址 ， 并 使 用 notifyChange0 方 法 ， 通 知 注册 在 此 URI 
上 的 观察 者 数据 发 生 了 改变 ; 

25 一 27 行 ， 异 常 处 理 。 


6. delete(Uri uri, String selection, String[] selectionArgs) 方 法 


该 方法 用 于 数据 的 删除 ， 返 回 的 是 删除 数据 的 数目 。 在 删除 时 ， 需 要 判断 删除 的 数据 
是 一 个 集合 的 数据 还 是 单个 数据 ， 并 采取 相应 的 删除 方法 。 在 本 示例 中 ， 利 用 数据 库 辅 助 
类 来 删除 记录 。 有 具体 实现 如 下 : 


01 
02 
{ 

03 
04 
05 
06 
07 
08 


. 164 . 


@Override 
public int delete (Uri uri, String selection, String[] selectionArgs) 


// TODO Auto-generated method stub 
SQLiteDatabase db = dbhelper.getWritableDatabase(); 
int count = 0; 
switch (sUriMatcher.match(uri)) { 
Case BOOKS RECORDS: 
count = db.delete (Bookinfo.TABLE NAME, selection, 
selectionArgs); 


// 当 是 记录 集合 时 ， 删 除 该 记录 
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09 break; 

10 case BOOK RECORD: // 当 是 单条 记录 时 

EB String rowID = uri.getPathSegments() .get (1); 
// 获 取 记 录 的 id 号 

了 人 String where = Bookinfo. ID+ "="+ rowID 

3 + (!TextUtils.isEmpty(selection) ? " AND ("+ 

selectionArgs+ ')， : ""); // 查 询 该 id 号 的 图 书信 息 
14 count = db.delete (Bookinfo.TABLE NAME, where, 
selectionArgs); // 删 除 该 记录 

于 break; 

16 default: 

玉 了 throw new IllegalArgumentException ("Unknown URI " + uri); 
// 抛 出 异常 

18 } 

9 db.close(); // 关 闭 数据 库 

20 this.getContext() .getContentResolver () .notifyChange (uri, null); 
// 通 知 数 据 更 改 

2 return count; 

} 


其 中 ，01 一 05 行 ， 定 义 需 要 使 用 到 的 变量 ; 
06 一 09 行 , 对 URI 地 址 进行 判断 ， 当 删除 的 是 多 个 数据 时 ， 直 接 使 用 数据 库 的 删除 方 


法 删除 数据 ; 


10 一 15 行 ， 当 删除 的 是 单个 数据 时 ， 首 先 从 地 址 中 获取 需要 删除 的 记录 的 id 号 ， 然 


后 加 入 其 他 附加 条 件 ， 最 后 执行 数据 删除 操作 ; 


灌 


16 一 18 行 ， 其 他 情况 时 ， 表 明 是 错误 地 址 ; 
19 一 21 行 ， 数 据 库 操作 完成 后 ， 关 闭 数据 库 ， 并 且 通 知 数据 发 生 了 变化 。 


7. update(Uri uri, ContentValues values, String selection, String[] selectionArgs) 方 法 


该 方法 用 于 修改 更 新 数据 ， 和 删除 的 方法 类 似 ， 都 需要 判断 修改 的 数据 是 集合 数据 还 
个 数据 。 具 体 实现 如 下 : 





01 @Override 
02 Public int update (Uri uri, ContentValues values, String selection, 
String[] selectionArgs) { 
03 // TODO Auto-generated method stub 
04 SQLiteDatabase db = dbhelper.getWritableDatabase(); 
05 int count = 0; 
06 Switch (sUriMatcher .match (uri)) { 
07 case BOOKS RECORDS: 
08 count = db.update (Bookinfo provider.BOOKS TABLE NAME, 
values, 
09 selection，selectionArgs); // 当 是 记录 集合 时 , 更 新 记录 
10 break; 
条 case BOOK RECORD : // 当 是 单条 记录 时 
le String rowID = uri.getPathSegments() .get (1); 
// 获 取 记 录 id 号 
13 String where = Bookinfo. ID+ "="+ rowID 
14 + (!TextUtils.isEmpty(selection) ? " AND(" + 
selection+ ')" : "™"); // 查 询 该 id 号 的 图 书信 息 
5 count = db.update (Bookinfo provider.BOOKS TABLE NAME, 
values, 
16 where, selectionArgs); // 更 新 该 记录 
eh break; 
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18 
9 
20 
21 


22 
23 


上 


default: 

throw new IllegalArgumentException ("Unknown URI "+ uri); 
h 
getContext () .getContentResolver () .notifyChange (uri, null); 
// 通 知 数据 更 改 


return count; 


其 中 ，07 一 10 行 ， 对 修改 的 数据 为 集合 时 的 处 理 ， 直 接 使 用 数据 库 修改 方法 ; 
11 一 17 行 ， 对 修改 的 数据 为 单个 数据 时 的 处 理 ， 需 要 的 查询 条 件 更 多 。 和 delete 方法 
的 处 理 类 似 。 


8. query(Uri uri, String[] projection, String selection, String[] selectionArgs, String 
sortOrder) 方 法 


该 方法 用 于 查询 数据 ， 将 查询 的 数据 放 入 cursor 对 象 中 并 返回 。 根 据 地 址 判断 查询 的 


是 集合 还 是 


01 
02 


04 
05 
06 
07 
08 
09 








个 数据 ， 然 后 采取 不 同 的 方式 来 完成 查询 操作 。 具 体 实现 如 下 : 


@Override 
public Cursor query (Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) 03 


} 


// TODO Auto-generated method stub 
Cursor cursor = null; 
SQLiteDatabase db = dbhelper.getReadableDatabase(); 
Switch (sUriMatcher.match(uri)) { 
Case BOOKS RECORDS: 
cursor = db.query (Bookinfo provider.BOOKS TABLE NAME, 
projection, 
selection, selectionArgs, null, null, sortOrder); 
// 当 是 记录 集合 时 ， 查 询 记录 
break; 
case BOOK RECORD: // 当 是 单条 记录 时 
String id = uri.getPathSegments() .get (1); // 获 取 记 录 id 号 
cursor = db.query (Bookinfo provider.BOOKS TABLE NAME, 
projection, 
Bookinfo. ID+"="+ id+ (!TextUtils.isEmpty 
(selection) ? " AND (" 


+selectionArgs+')':""), selectionArgs,null, null, 
sortOrder); // 查 询 该 id 号 的 记录 
break; 
default: 
throw new IllegalArgumentException ("Unknown URI " + uri); 
// 抛 出 异常 
员 
ContentResolver cr = this.getContext () .getContentResolver(); 
cursor .setNotificationUri(cr，uri) ; // 通 知 数据 更 改 
return cursor; // 返 回 查询 结果 


其 中 ，08 一 11 行 ， 对 多 个 数据 的 查询 处 理 ， 直 接 使 用 数据 库 查 询 方法 ; 
12 一 17 行 , 对 单个 数据 的 查询 处 理 , 需要 的 查询 条 件 更 多 。 和 delete 方法 的 处 理 类 似 。 


9. AndroidManifest 配 置 














为 了 能 让 其 他 应 用 找到 该 ContentProvider ，ContentProvider 采用 了 authorities (主机 


*166°* 











第 4 章 Android 数据 存储 








名 /域名 ) 对 它 进行 唯一 标识 。 这 个 标识 必须 在 AndroidManifest xml 文件 中 定义 , 具体 实现 
如 下 : 


<provider android:name=".Ex contentprovider" 


android:authorities="com.ouling.bookinfo provoider" /> 


4.7.3 内 容 解 析 器 (ContentResolver) 


类 相 


当 外 部 应 用 需要 对 上 个 应 用 中 的 ContentProvider 数据 进行 添加 、 删 除 、 修 改 和 查询 操 
作 时 , 可 以 使 用 ContentResolver 类 来 完成 -ContentResolver 类 同样 提供 了 与 ContentProvider 





司 的 4 种 方法 : 

口 public Uri insert(Uri uri, ContentValues values): 该 方法 用 于 往 ContentProvider 添加 
数据 

口 public int delete(Uri uri，String selection，String[] selectionArgs): 该 方法 用 于 从 
ContentProvider 删除 数据 。 

口 public int update(Uri uri， ContentValues values, String selection, String[] 
selectionArgs): 该 方法 用 于 更 新 ContentProvider 中 的 数据 。 

口 public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, 


String sortOrder): 该 方法 用 于 从 ContentProvider 中 获取 数据 。 


这 4 种 方法 和 数据 库 对 应 的 方法 类 似 ， 只 是 ContentResolver 在 第 一 个 参数 中 使 用 了 
URI 地 址 。 

新 建 一 个 应 用 程序 ， 在 该 程序 中 ， 通 过 内 容 解 析 器 ContentResolver 来 操作 内 容 提 供 者 
ContentProvider 的 数据 。 在 新 程序 中 分 别 对 内 容 提供 者 的 添加 、 删 除 、 修 改 、 碍 询 方法 进 
行 测试 。 有 具体 代码 如 下 : 


01 
02 
03 


// 添 加 
public void test insert() throws Throwable { 
ContentResolver cr = this.getContentResolver(); 


// 获 取 内 容 解析 器 
Uri inserturi = Uri.parse("content://com.ouling.bookinfo 
provoider/books"); // 设 置 URI 
ContentValues cv = new ContentValues () ; // 实 例 化 数据 容器 
cv.put ("name", "Android"); // 设 置 图 书 名 
cv.put ("isbn", "123456"); // 设 置 ISBN 号 


Uri re uri = cr.insert(inserturi，cv) ; // 添 加 图 书信 息 
System.out.println("test insert:" + re uri); 


// 删 除 


public void test delete() throws Throwable { 
ContentResolver contentResolver = getContentResolver(); 


// 获 取 内 容 解析 器 
Uri uri = Uri.parse("content://com.ouling.bookinfo 
provoider/books/1"); // 设 置 id 号 为 1 的 记录 的 URI 地址 


contentResolver.delete (uri，null，null) ;// 删 除 该 记录 
1 


// 修 改 
public void test_update () throws Throwable { 
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} 


ContentResolver contentResolver = getContentResolver () : 


// 获 取 内 容 解 析 器 
Uri updateUri = Uri.parse("content://com.ouling.bookinfo 
provoider/books/2"); // 设 置 id 号 为 2 的 记录 的 URI 地址 
ContentValues values = new ContentValues(); // 实 例 化 数据 容器 
values .put ("name"，"Android 示例 "); // 设 置 图 书 名 
contentResolver .update (updateUri, values, null, null); 

// 修 改 该 记录 


System.out.println(" 修 改 完成 ") ; 


// 查询 
public void test find() throws Throwable { 


ContentResolver contentResolver = getContentResolver(); 
// 获 取 内 容 解 析 器 

Uri uri = Uri.parse("content://com.ouling.bookinfo 
Provoider/books"); // 设 置 查询 的 URI 地 址 
Cursor cursor = contentResolver.query (uri, null, null, null, "id 
asc"); // 查 询 
System.out .println ("查询 结果 一 共有 "+ cursor.getCount () + "条 记 
录 ， 具 体 是 : "); 
while (cursor.moveToNext()) { // 遍 历 查询 结果 

String id = cursor.getString(0);  // 获 取 id 号 

String name=cursor.getString(1);  ”// 获 取 图 书 名 

String isbn=cursor.getString(2); ”// 获 取 图 书 ISBN 号 

String author=cursor.getString (3); // 获 取 图 书 作 者 

System.out.println("id=" + id + ",name=" + name+ ",isbn=" 

+ isbn+",author="+author); 
} 


cursor.close(); 


其 中 ，01 一 11 行 ， 使 用 ContentResolver 来 添加 数据 。04 行 的 地 址 表示 com.ouling. 
bookinfo_provoider 中 的 books 表 ; 
12 一 18 行 ， 使 用 ContentResolver 来 删除 数据 。15 行 的 地 址 表示 com.ouling.bookinfo_ 


provoider 中 的 books 表 的 id 为 1 的 记录 ; 


19 一 28 行 ， 使 用 ContentResolver 来 修改 数据 。22 行 的 地 址 表示 com.ouling.bookinfo_ 


provoider 中 的 books 表 的 id 为 2 的 记录 ; 











29 一 43 行 ， 使 用 ContentResolver 来 查询 数据 。32 行 的 地 址 表示 com.ouling.bookinfo_ 
provoider 中 的 books 表 ， 查 询 的 结果 即 表 中 的 所 有 数据 。 


4.7.4 





运行 分 析 总 结 


分 别 安装 调试 内 容 提供 者 ContentProvider 程序 和 内 容 解析 器 ContentResolver 程序 。 在 
数据 使 用 的 程序 ex_test myprovider 中 ， 调 用 3 次 添加 数据 方法 后 ， 再 调用 删除 数据 的 方 
法 、 修 改 数据 的 方法 和 查询 数据 的 方法 。 其 打印 结果 如 图 4.43 所 示 。 从 结果 中 可 以 看 出 首 
先 在 books 表 中 , 添加 了 id 为 1、2、3 的 3 条 记录 。 从 最 后 查询 的 结果 可 以 看 出 ， 已 经 删 
除了 id 为 1 的 记录 ， 并 将 id 为 2 的 记录 的 书 名 修改 为 “Android 示例 ”。 
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衣 toscst 3 console 
[aaa wet 
















Message 
test_insert :content :Com es bookinfo_provoider/books/1 
test_insert :content ;//com.ouling .bookinfo_provoider/books/2 


test_insert :content : i 


图 4.43 打印 结果 











再 看 一 下 两 个 应 用 程序 中 的 文件 , 内 容 提供 者 程序 ex_contentprovider 中 是 否 有 提供 的 
数据 库 文 件 ， 内 容 解析 器 程序 ex_test_ myprovider 中 又 包含 哪些 文件 ， 结 果 如 图 4.44 所 示 。 



























Size Date Tine 。 Permiss 
2011-09-03 ”20;25 drwxr-x--x 
2011-09-26 
2011-09-26 


Info 


201109 2 
困 世 com.ouling ex_b 2011-09-11 10:52 drwer-x—x 
BB eon ouling ex_file 2011-08-30 22:17 drwxr-x--x 
一世 em. 和 2011-09-11 21:39 drwer-x—x 
2011-09-18 22'59 drwer-x-—x 
2011-09-26 08:58 drwer-x—x 

c 2011-09-26 08:58 drwer-xr-x 
BB com svor Pico 2010-10-10 17:00 drwar-x—x 











图 4.44 文件 目录 


数据 库 文 件 books.db 存在 于 ex_contentprovider 程序 目录 中 ， 而 操作 数据 的 程序 
ex_test_myprovider 目录 中 没有 任何 文件 。 由 此 说 明 ， 实 现 了 数据 的 共享 。 

将 数据 库 文件 books.db 导出 ,使 用 SQLitSpy 工具 查看 数据 库 结果 如 图 4.45 所 示 。books 
表 中 的 内 容 和 查询 的 结果 ， 和 图 4.43 是 一 致 的。 这 样 更 确定 了 ex_test_myprovider 程序 能 
够 操作 ex_contentprovider 程序 中 的 数据 ， 实 现 数 据 共享 。 


DD OT Or ET TI7 








M0 Dy 











图 4.45 数据 库 结果 
4.8 系统 通讯 录 


在 Android 系统 中 ， 一 般 的 应 用 程序 不 会 将 自己 的 数据 暴露 给 其 他 应 用 程序 使 用 。 而 
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对 于 Android 手机 中 都 存在 的 通讯 录 、 短 信 、 通 话 记 录 、 上 网 记录 以 及 下 载 记录 等 信息 都 
是 使 用 数据 库 来 保存 ， 并 使 用 ContentProvider 来 提供 给 其 他 应 用 程序 来 维护 其 数据 的 。 这 
一 节 ， 我 们 将 探究 通讯 录 在 系统 中 的 保存 机 制 以 及 如 何 查 询 获取 通讯 录 数 据 ， 进 一 步 熟悉 
对 共享 数据 的 操作 。 














4.8.1 系统 通讯 录 的 保存 


通讯 录 是 系统 本 身 自 带 的 功能 ， 但 是 默认 为 空 。 为 了 方便 看 到 结果 ， 我 们 向 系统 通讯 
录 中 添加 一 些 数据 。 选 择 主 界面 中 名 为 Contacts 的 应 用 ， 如 图 4.46 所 示 。 在 Contacts 界面 
中 ， 选 择 New contact 进行 添加 ， 如 图 4.47 所 示 。 


一 Ta me mr 


- 有 


Contacts 


Calculator 


ES 00 


DevTools 


|=] ouling1 


Q 


Search 


全 年 生 


Display options Accounts Import/Export 





图 4.46 ”Contacts 应 用 图 4.47 添加 系统 联系 人 


在 系统 通讯 录 中 添加 好 数据 后 ， 我 们 来 看 看 通讯 录 的 数据 库 文件 保存 的 这 些 联系 人 的 
信息 。 在 Eclipse 中 切换 到 DDMS 视图 ， 选 择 File Explorer 标签 。 打 开 目 录 data/data， 发 
现 文 件 夹 com.android.providers.contacts, 该 目录 下 保存 的 数据 库 文件 contacts2.db 就 是 系统 
存储 联系 人 的 数据 库 ， 如 图 4.48 所 示 。 


等 Threads | 目 leap | 目 location Tracker BTile Explorer 23 


Tane Size Date Tine Perniss... I 
EE eon. android packageinstaller 2010-10-10 17:00 。 arer-x--x 
HG con. android phone 2010-10-10 17:01 。 drwxr-x--x 
BB con. android protips 2010-10-11 01:03 drwxr-x—x 
由 世 com. android providers. applications 2010-10-10 16:56 drwxr-x--x 
SB con. android providers. contacts 2010-10-10 17:00 ”drwxr-x 一 x 


2011-09-03 








21:00 





ETE 
2010-10-10 2 16:59 
2010-10-11 01:02 drwow—x 
TE com. android providers. downloads 2010-10-10 17:02 drwxr-x-—x 





图 4.48 系统 通讯 录 的 数据 库 文件 
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OO TI 


将 该 数据 库 文件 contacts2.db 导出 ， 看 看 系统 到 底 如 何 保 ET 
存 联系 人 信息 的 。 当 然 ， 我 们 是 在 模拟 器 中 导出 contacts2.db | as pp Wm 
文件 。 如 果 想 查看 真 机 的 contacts2.db， 需 要 具有 root 权限 ， | ga 
否则 无 法 获得 。 真 机 的 contacts2.db 文件 结构 和 模拟 器 中 的 差 
:3 





别 不 大 ， 甚 至 可 以 说 关键 的 表 都 是 一 模 一 样 的 ， 所 以 探究 模拟 
器 的 contacts2.db 已 经 能 够 达到 我 们 的 目的 。 

使 用 SQLite 数据 库 查看 工具 对 SQLiteSpy.exe 进行 查看 ， 
如 图 4.49 所 示 。 

由 图 4.49 可 知 ， 系 统 中 使 用 了 22 张 表 来 记录 通讯 录 的 相 
关 信息 。 虽 然 表 很 多 ， 但 是 大 部 分 不 需要 过 多 的 深究 ， 只 需要 
注意 最 常 使 用 的 3 张 表 : contacts、data 和 raw_contacts。 





1. contacts 表 


该 表 用 于 记录 联系 人 的 基本 属性 ， 如 联系 人 id、 头 像 id、 
联系 次 数 、 最 后 联系 时 间 、 分 组 等 信息 。 使 用 SQLiteSpy 查看 





contacts 表 内 信息 ， 结 果 如 图 4.50 所 示 。 图 4.49 系统 通讯 录 表 
id name_raw_contact id photo_id custom_rin,,, send_to_v,,， times_cont,,, last_time_con,,, starred 
1 1 6 0 0 0 0 
名 之 0 0 0 0 
in_wisible_g,,，_has_phone_nu,,， lookup status,,, w single_is_restricted 
1 1 Drl-4854423C4638297E 0 
. 人 Dr2-297C297C 0 


图 4.50 ”contacts 表 


其 中 : 

口 _id 是 该 表 的 主键 ， 具 有 自 增 性 。 

口 name raw_contact id 是 联系 人 的 id 号 ， 与 raw_contact 表 中 的 id 关联 ， 通 过 它 可 
以 查询 到 其 他 表 中 的 数据 。 

口 photo id 是 头像 的 ID， 如 果 没 有 设置 联系 人 头像 ， 这 个 字段 就 为 空 。 

口 has phone _number 表示 是 否 有 电话 号 码 ， 值 为 1， 表 示 至 少 有 1 个 电话 号 码 。 值 为 
0， 表 示 没 有 。 


2. data 表 


该 表 用 于 保存 联系 人 的 具体 信息 ， 查 看 结果 如 图 4.51 所 示 。 
其 中 ， 第 四 列 raw_contact id 是 联系 人 id 号， 与 raw_contact 表 中 的 id 关联 。datal 一 
datal5 保存 着 联系 人 的 信息 ， 包 括 联系 人 名 称 、 电 话 号 码 、 电 子 邮 件 、 地 址 以 及 备注 等 等 。 





3. raw_contacts 


该 表 用 于 保存 联系 人 姓名 、 版 本 号 等 信息 ， 查 看 结果 如 图 4.52 所 示 。 
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_ 了 加 pack..， mimetype id raw contact id is_primary is_sup... data vy... datal data2 
和 6 1 0 0 1 ‘ouling! ouingl 
2 5 1 0 0 0 1-234-567-8901 1 
3 5 1 0 0 0 012-345-6769 2 
4 3 了 0 0 0 成 都 , 中 国 1 
5 国 0 0 0 ouing00G@126.com 1 
6 1 0 1 0 
学 5 2 0 0 0 11-334-422-5566 1 
8 6 2 0 0 0 00 00 
data3 data4 data5 data6 data7 data6 data9 datal0 datall 
1 0 
10987654321 
9676543210 
成 都 ”中 国 
665522443311 
0 0 
图 4.51 data 表 


lH ses.,, accou.,, accou.., sou... verson dity deleted contactid 鸭 .， 399 cust +} 
0 6 1 0 1 0 0 
C2 0 2 1 0 他 0 0 


send.t,,, tim,,, last time_contacted starred display_name display_name a display_name.s,,, phonetic ne 
0 0 0 ouingl ouingl 4 
0 0 oo m 4 


图 4.52 raw_contacts 表 


其 中 : 

口 contact id 是 联系 人 id 号 。 

口 version 是 版 本 号 ， 用 于 监听 联系 人 信息 是 否 变 化 ,每 修改 一 次 , 版 本 号 自 增 一 次 。 

口 deleted 是 删除 标志 ，0 为 默认 ，1 表示 这 行 数据 已 经 删除 。 

口 display_name 是 联系 人 名 称 。 

在 获取 系统 通讯 录 的 内 容 时 ， 就 是 通过 对 上 面 3 张 表 的 查询 来 获得 信息 的 。 接 下 来 ， 
我 们 来 实现 获取 通讯 录 中 联系 人 的 信息 。 


4.8.2 获取 通讯 录 联 系 人 信息 


1. 功能 说 明 


在 界面 中 提供 一 个 “更 新 通讯 录 ” 按 钮 ， 用 于 获取 通讯 录 信息 ， 使 用 ListView 来 显示 
获得 的 信息 结果 ， 效 果 如 图 4.53 所 示 。 这 一 小 节 中 ,不 仅 要 掌握 对 通讯 录 中 多 张 表 的 查询 
方法 ， 也 将 回顾 ListView 的 使 用 。 


2. 联系 人 信息 获取 


首先 明确 我 们 需要 获得 的 联系 人 信息 包括 哪些 ， 如 联系 人 姓名 、 联 系 人 电话 号 码 、 联 
系 人 的 邮件 地 址 、 联 系 人 的 住址 以 及 联系 人 的 头像 信息 。 将 联系 人 信息 作为 一 个 类 进行 封 
装 ， 代 码 如 下 : 
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图 4.53 ”获取 联系 人 信息 


public class Contactinfo { 
public Bitmap pho=null; 
public String tel name=" 姓 名 "; 
public String tel phone=" 电 话 号 码 "; 
public String email=" 邮 件 地 址 "; 
public String address=" 住 址 "; 
} 
(1) 读 取 系统 通讯 录 权限 
程序 要 对 系统 的 通讯 录 进 行 读 取 、 修 改 、 删 除 等 操作 ， 必 须 申请 相对 应 的 权限 。 在 本 
悍 序 中 只 需要 读 取 通 讯 录 信息 ， 所 以 在 AndroidManifest xml 中 加 入 读 取 通讯 录 的 权限 ， 代 
个 如 下 : 
<!-- 读 取 通 讯 录 --> 
<uses-permission android:name="android.permission.READ CONTACTS"/> 
(2) 查询 contacts 表 
系统 的 通讯 录 本 质 上 也 是 系统 的 一 个 应 用 程序 ， 只 是 它 将 自身 的 私有 数据 进行 了 共 
享 ， 只 要 申请 了 相应 权限 就 能 对 其 数据 进行 操作 。 系 统 通讯 录 使 用 ContentProvider 来 暴露 
自身 私有 数据 ; 同时 ， 其 他 程序 可 以 通过 ContentResolver 接口 访问 ContentProvider 提供 的 
数据 ， 以 此 达到 数据 在 应 用 程序 之 间 的 共享 。 
获取 ContentResolver， 只 需要 调用 Context 的 getContentResolver0 方 法 即 可 。 
ContentResolver 采用 类 似 数据 库 的 操作 从 Content providers 中 获取 数据 。 例 如 ， 查 询 操作 : 
query (Uri uri，String[] projection, String selection，String[] selectionArgs, 
String sortOrder) 
其 中 ， 第 一 个 参数 是 资源 地 址 ;第 二 个 参数 是 列 名 称 数组 ; 第 三 个 参数 是 条 件 子 句 ， 
相当 于 where; 第 四 个 参数 是 条 件 子 句 ， 参 数 数组 ， 第 五 个 参数 是 排序 列 方式 。 例 如 ， 查 
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询 contacts 表 的 内 容 ， 代 码 如 下 : 
Uri uri = ContactsContract.Contacts -CONTENT URI; 
Cursor cu = getContentResolver() .query (uri, null, null, null, null); 
其 中 ，uri 是 contacts 表 的 资源 地 址 。 
获得 了 Contacts 表 内 容 后 ， 就 可 以 直接 获得 联系 人 姓名 、 联 系 人 头像 以 及 联系 人 id， 
然后 通过 联系 人 id 获得 其 他 信息 。 具 体 代码 实现 如 下 : 


01 Uri uri = ContactsContract.Contacts .CONTENT URI; 
// 系 统 联 系 人 URI 地 址 
02 Cursor cu = getContentResolver() .query (uri, null, null, null, 
nul1); // 查 询 系统 联系 人 
03 
04 while (cu.moveToNext()) { // 遍 历 查 询 结果 
05 // 联 系 人 iq, id 作为 唯一 标识 ， 查 询 其 他 表 时 需要 
06 String contact id = cu.getString (cu 
07 .getColumnIndex (ContactsContract. 
Contacts. ID) ) 
08 // 头 像 id 
09 Long Photo id = cu.getLong (cu 
10 -getColumnIndex (ContactsContract.Contacts . 
PHOTO ID) ) ; 
tt // 得 到 联系 人 头像 Bitamp 
12 Bitmap contactPhoto = null; 
13 //photoid 大 于 0 表示 联系 人 有 头像 , 如 果 没 有 给 此 人 设置 头像 则 给 他 一 个 
默认 的 

14 if(photo id > 0 ) 1{ 
15 Uri photo uri =ContentUris.withAppendedId( 
16 ContactsContract.Contacts .CONTENT URI,Long. 

valueOf (contact id)); 
区/ InputStream input = ContactsContract. 

Contacts .openContactPhotoInputStream( 
18 resolver，Pphoto_uri) ; // 获 取 头 像 的 输入 流 
19 contactPhoto = BitmapFactory.decodeStream(input) 7 

// 设 置 头像 

20 }else { 
ZL contactPhoto = BitmapFactory.decodeResource 


(getResources(), R.drawable.icon); 


// 无 头像 时 ,设置 为 默认 头像 


2 之 1 

3 ctinfo.pho=contactPhoto; 

24 // 姓 名 

25 String contact name = cu.getString(cu.getColumnIndex( 

26 ContactsContract.Contacts . 
DISPLAY NAME)); 

2 // 保 存 联系 人 姓名 

28 ctinfo.tel name = Contact name; 

29 // 电 话 ， 判 断 是 否 有 ， 可 能 有 多 个 

30 String has phone = cu.getString(cu.getColumnIndex( 

3 ContactsContract.Contacts.HAS 


PHONE NUMBER)); 


其 中 ，01 一 03 行 ， 查 询 通讯 录 中 的 所 有 联系 人 ， 查 询 结果 放 入 游标 cu 中 ; 
04 行 ， 遍 历 游标 ， 获 取 查 询 结 果 ; 
05 一 07 行 ， 获 取 联 系 人 id 号 。getColumnIndex(ContactsContract.Contacts. ID)) 表 示 获 
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得 列 名 为 ContactsContract.Contacts. ID 的 列 号 ，cu.getLong() 表 示 获 取 第 几 列 的 值 ; 

08 一 10 行 ， 获 取 联 系 人 头像 id 号 ; 

11 一 14 行 ， 根 据 头 像 id 号 进行 判断 ， 如 果 值 大 于 0 表示 联系 人 有 头像 ， 并 根据 id 号 
获取 该 头像 ， 和 否则 表示 此 人 没有 头像 ， 则 设置 一 个 默认 头像 ; 

15 一 19 行 ， 获 取 头 像 id 号 所 对 应 的 图 片 。15 一 16 行 ， 将 用 户 ID 添加 到 路 径 的 末尾 ， 
获取 图 片 资源 地 址 ; 17 一 18 行 ， 使 用 openContactPhotoInputStream 方法 将 图 片 文件 写 入 输 
入 流 中 ; 19 行 ， 将 输入 流 保 存 为 图 片 文件 ; 

20 一 22 行 ， 联 系 人 没有 设置 头像 ， 则 将 其 头像 设置 为 程序 中 的 资源 图 片 ; 

24 一 28 行 ， 获 取 联 系 人 姓名 ; 

29 一 31 行 , 获取 联系 人 是 否 有 电话 。 当 该 值 为 1 时 , 表示 联系 人 至 少 有 一 个 电话 号 码 ; 
其 他 值 时 ， 表 示 联 系 人 没有 电话 号 码 。 

(3) 查询 data 表 

联系 人 的 电话 号 码 、 邮 件 地 址 、 住 址 等 具体 信息 保存 在 data 表 中 ， 所 以 更 加 详细 的 信 
息 需 要 通过 联系 人 的 id 号 对 data 表 进 行进 一 步 的 查询 获得 。 方 法 和 查询 Contacts 表 是 相同 
的 ， 只 是 各 自 的 资源 地 址 不 一 样 。 其 中 : 

ContactsContract.CommonDataKinds.Phone.CONTENT _URI 是 data 表 中 电话 资源 地 址 ; 

ContactsContract.CommonDataKinds.Email.CONTENT_URI 是 data 表 中 电子 邮件 资源 
地 址 。 

获取 联系 人 的 电话 号 码 和 邮件 地 址 的 具体 实现 如 下 : 




















01 if (has phone.equalsIgnoreCase("1")) // 如 果 有 电话 
02 上 
03 // 根 据 id 号 ， 查 询 该 id 下 所 有 电话 ， 可 能 有 多 个 
04 Cursor phone cur = getContentResolver() .query( 
05 ContactsContract .CommonDataKinds .Phone.CONTENT URI, 
06 null, 
07 ContactsContract.CommnonDataKinds .Phone.CONTRACT ID 
08 + "=" + contact id, null, null); 
09 
10 while (phone _cur.moveToNext ()) { ，// 遍 历 查 询 到 的 所 有 电话 号 码 
11 String phone nums = phone cur.getString(phone cur 
la .getColumnIndex (ContactsContract .CommonDataKinds. 
Phone .NUMBER) ) ; 
3 // 保 存 联系 人 电话 
14 ctinfo.tel _ phone += phone nums + "7"7 
5 } 
16 // 使 用 完 ， 关 闭 游标 
eh Phone cur.close(); 
18 } 
9 
20 //Email 
2 Cursor email cur = getContentResolver() .query( 
a ContactsContract.CommonDataKinds .Email .CONTENT URI, 
PP null, 
24 ContactsContract .CommonDataKinds .Email .CONTACT ID + "=" 
25 + contact id, null, null); 
// 查 询 指 定 id 号 的 所 有 Email 地 址 
26 
受 光 while (email cur.moveToNext()) { // 遍 历 查询 到 的 所 有 Email 地 址 
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28 
29 


30 
31 
3 
33 


String emails = email cur.getString (email cur 
.getColumnIndex (ContactsContract .CommonDataKinds. 
Email .DATA)); 
ctinfo.email += emails + ™;i"; 
} 
/ /关闭 游标 


email cur.close(); 


其 中 ，01 一 03 行 ， 判断 是 否 有 电话 号 码 ， 如 果 没 有 电话 则 不 获取 电话 号 码 ; 如 果 有 电 
话 号 码 ， 则 获取 联系 人 所 有 的 电话 号 码 ; 
04 一 08 行 , 查询 电话 号 码 , 返回 data 表 中 联系 人 id 与 获得 的 联系 人 id 一 致 的 所 有 项 ， 


即 获得 联系 人 的 所 有 电话 号 码 ; 








09 一 18 行 ， 保 存 联系 人 的 所 有 电话 号 码 ， 并 关闭 使 用 后 的 电话 信息 游标 ; 
20 一 25 行 , 查询 电子 邮件 , 返回 data 表 中 联系 人 id 与 获得 的 联系 人 id 一 致 的 所 有 项 ， 


即 获 得 联系 人 的 所 有 电子 邮件 地 址 ; 














26 一 33 行 ， 保 存 联系 人 的 所 有 邮件 地 址 ， 并 关闭 使 用 后 的 邮件 地 址 信息 游标 。 
联系 人 地 址 同样 是 查询 data 表 获 取得 的 ,但 是 其 资源 地 址 为 ContactsContract.Common- 
DataKinds.StructuredPostal.CONTENT_URI。 实 现 获得 联系 人 地 址 的 具体 实现 代码 如 下 : 


01 
02 
03 


04 
05 


06 


07 


08 


09 


10 


EE 


12 


3 


14 


15 


16 
by 


18 
了 号 
20 
二 
2Z2 
区 本 | 
24 
5 


“Gs 





// 查 询 地 址 ， 可 能 多 个 

Cursor address = getContentResolver() .query( 
ContactsContract.CommonDataKinds.StructuredPostal. 
CONTENT URI, 


null, 
ContactsContract.CommonDataKinds.StructuredPostal. 
CONTACT ID 
"ms "+ contact ad al nall)s 


// 查 询 指 定 id 的 所 有 地 址 


while (address.moveToNext ()) { // 遍 历 所 有 查询 到 的 地 址 
sbBuilder .append (address .getString (address .getColumnIndex 


(ContactsContract. 
CommonDataKinds.StructuredPostal .FORMATTED 
RDDRESS) )) ; // 获 取 完 整 的 地 址 数据 
int type = address.getInt (address.getColumnIndex 
(ContactsContract. 
CommonDataKinds .StructuredPostal .TYPE) ) 


// 获 取 地 址 类 型 编号 
if (type == ContactsContract.CommonDataKinds .StructuredPostal . 
TYPE HOME) { 
sbBuilder .append ("家 庭 住址 "); 
// 如 果 是 家 庭 住 址 编号 ， 则 添加 “家 庭 住 址 ” 
} else if (type == ContactsContract.CommonDataKinds. 
StructuredPostal .TYPE WORK) { 
sbBuilder .append ("工作 地 址 "); 
} else if (type == ContactsContract.CommonDataKinds. 
StructuredPostal .TYPE OTHER) { 
sbBuilder .append ("其 他 地 址 "); 
} 
和 
ctinfo.address = sbBuilder.toString(); 
// 清 空 StringBuilder 
sbBuilder.setLength (0); 
address.close(); 


// 添 加 通讯 录 信息 到 1ist 
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26 contactinfo list.add(ctinfo); 

2 

其 中 ，01 一 06 行 ， 查 询 联 系 人 地 址 ， 返 回 data 表 中 联系 人 id 与 获得 的 联系 人 id 一 致 
的 所 有 项 ， 即 获得 联系 人 的 所 有 地 址 ; 

07 一 20 行 ， 保 存 联系 人 的 所 有 地 址 。 其 中 ， 地 址 类 型 分 为 3 类 : 以 int 类 型 保存 ， 则 
TYPE HOME 值 为 1，TYPE WORK 值 为 2，TYPE _ OTHER 值 为 3; 

21 一 24 行 ， 保 存 地 址 信息 ， 清 空 StringBuilder 并 关闭 地 址 游标 ; 

25 一 27 行 ， 将 获得 的 联系 人 完整 信息 保存 在 数组 中 ， 以 便 与 Listview 的 数据 相关 联 和 


显示 。 





| 


4.8.3 显示 通讯 录 联系 人 


由 于 获得 的 联系 人 信息 比较 多 ， 只 有 自 定 义 布局 的 ListView 才能 显示 全 部 信息 。 前 面 
的 章节 介绍 过 ， 自 定义 布局 的 ListView 主要 分 为 3 步 来 实现 : 

第 一 步 ， 定 义 ListView 中 的 每 一 栏 布局 ; 

第 二 步 ， 重 写 继承 至 BaseAdapter 的 自己 的 My_Adapter， 主 要 是 重 写 getView(int 
position, View convertView, ViewGroup parenb 以 实现 每 一 栏 的 绘制 ; 

第 三 步 ， 定 义 ListView 的 布局 与 数据 关联 。 


1. ltem 布 局 


由 于 获得 的 联系 人 数据 包括 了 联系 人 的 头像 、 姓 名 、 电 话 号 码 、 邮 件 地 址 以 及 住址 ， 
所 以 每 一 项 设计 为 最 左边 是 头像 ， 右 边 一 共 3 行 数据 ， 分 别 显示 姓名 和 电话 号 码 、 邮 件 地 
址 、 住 址 ， 如 图 4.54 所 示 。 





图 4.54 ListView 中 的 一 栏 


这 样 的 布局 使 用 的 是 相对 布局 RelativeLayout。 回 顾 一 下 相对 布局 的 一 些 重要 属性 : 





android:layout alignParentBottom 贴 紧 父 元 素 的 下 边缘 
android:layout alignParentLeft 贴 紧 父 元 素 的 左边 缘 
android:layout alignParentRight 贴 紧 父 元 素 的 右边 缘 
android:layout alignParentTop 贴 紧 父 元 素 的 上 边缘 
android:layout below 在 某 元 素 的 下 方 
android:layout above 在 某 元 素 的 上 方 
android:layout toLeftOf 在 某 元 素 的 左边 
android:layout toRightOf 在 某 元 素 的 右边 
android:singleLine="true" 强制 输入 的 内 容 在 单行 
android:ellipsize="marquee" 跑马 灯 显 示 


其 他 更 详细 的 属性 ， 可 以 查看 前 面 的 章节 。 具 体 实现 Item 布局 的 代码 如 下 : 


01 <?xml version="1.0" encoding="utf-8"?> 
02 <RelativeLayout xmlns:android="http://schemas .android.com/apk/res/ 
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android" 

03 android:layout width="fill parent" android:layout height= 
"wrap content"> 

04 <ImageView android:id="@+id/item image" android:layout width= 
"50dip" 

05 android:layout height="50dip" /> 

06 <TextView android:id="@+id/item title" 

07 android:layout width="fill parent" 

08 android:layout height="wrap content" 

09 android:layout toRightOf="@+id/item image" 

10 android:layout alignParentTop="true" 

了 android:layout alignParentRight="true" 

2 android:singleLine="true" 

3 android:ellipsize="marquee" 

14 android:textSize="15dip" /> 

15 <TextView android:id="@+id/item email" 

16 android:layout width="fill parent" 

yg android:layout height="wrap content" 

18 android:layout toRightOf="@+id/item image" 

19 android:layout below="@+id/item title" 

20 android:layout alignParentRight="true" 

2 android:singleLine="true" 

22 android:ellipsize="marquee" android:textSize="1l5dip" /> 

蕊 他 <TextView android:id="@+id/item address" 

24 android:layout width="fill parent" 

2 android:layout height="wrap content" 

26 android:layout toRightOf="@+id/item image" 

之 android:layout below="@+id/item email" 

28 android:layout alignParentBottom="true" 

29 android:layout alignParentRight="true" 

30 android:singleLine="true" 

Ei android:ellipsize="marquee" android:textSize="15dip" /> 


32 </RelativeLayout> 


其 中 ，01 一 03 行 ， 设 计 整 体 的 布局 为 相对 布局 ， 垂 直 排 布 ; 

04 一 05 行 ， 定 义 图 像 位 置 和 大 小 ; 

06 一 14 行 ， 定 义 第 一 行 位 置 ， 在 图 像 的 右边 ， 贴 紧 父 元 素 的 上 边缘 和 右边 缘 ， 单 行 跑 
马 灯 显示 ; 

15 一 22 行 ， 定 义 第 二 行 位 置 ， 在 图 像 的 右边 、 第 一 行 的 下 方 ， 贴 紧 父 元 素 的 右边 缘 ， 
单行 跑马 灯 显 示 ; 

23 一 32 行 ， 定 义 第 三 行 位 置 ， 在 图 像 的 右边 、 第 二 行 的 下 方 ， 贴 紧 父 元 素 的 下 边缘 和 
右边 缘 ， 单 行 跑马 灯 显 示 。 效 果 如 图 4.54 所 示 。 

2. My_Adapter 


为 了 实现 自 定义 格式 的 数据 显示 , 必须 自己 定义 继承 至 BaseAdapter 的 My_Adapter 适 
配器 来 装载 数据 。 继 承 BaseAdapter， 除 了 构造 函数 以 外 还 必须 实现 如 下 4 个 方法 : 

口 public int getCount0: 该 方法 设置 显示 的 项 目 数 ， 默 认 值 为 关联 数据 的 总 数 。 在 绘 

制 前 ， 先 调用 此 方法 得 到 绘制 的 数目 ， 即 显示 的 项 目 数 。 
口 getItem(int position): 该 方法 获取 在 指定 位 置 的 数据 集 相关 的 数据 项 。 在 本 示例 中 ， 
不 需要 获取 ， 默 认 返 回 null。 

口 getItemId(int position): 该 方法 获取 指定 位 置 的 行 号 。 本 示例 返回 为 null。 
口 getView(int position, View convertView, ViewGroup parent): 该 方法 获取 指定 位 置 的 
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视图 ， 即 增加 数据 绘制 出 在 ListView 中 每 一 项 的 显示 视图 。 


在 绘制 视图 时 ， 首 先 把 XML 表述 的 布局 转化 为 视图 ， 使 用 LayoutInflater 的 方法 : 


inflate (int resource, ViewGroup root) 


其 中 ， 第 一 个 参数 是 XML 的 布局 文件 ， 第 二 个 参数 默认 为 null。 

转化 为 视图 后 ， 就 可 以 和 其 他 对 视图 操作 一 样 ， 绑 定 控件 ， 设 置 显示 的 图 像 、 文 字 等 。 
由 于 ListView 的 特殊 性 ， 它 的 每 一 项 布局 是 相同 的 。 所 以 ， 在 Google 的 IO 大 会 上 提出 了 
一 种 提高 效率 的 方法 : 将 已 经 设置 好 的 布局 视图 以 设置 标签 的 形式 进行 保存 ， 下 次 使 用 时 
直接 读 取 该 标签 ， 减 少 了 绘制 每 一 项 时 ， 重 复 进 行 布局 文件 转化 为 视图 和 绑 定 等 操作 。 

设置 视图 标签 使 用 View 的 方法 : 

setTag (Object tag) 

该 方法 表示 设置 与 该 视图 关联 的 标签 。 标 签 可 以 用 来 标记 视图 ， 也 可 以 用 来 在 一 个 视 
图 中 存储 数据 ， 而 不 使 用 其 他 数据 结构 来 存储 数据 。 

我 们 也 采用 这 种 方式 来 实现 ListView 每 一 项 的 绘制 ， 具 体 实现 代码 如 下 : 


class ViewHolder 1{ // 列 表 项 视图 类 
ImageView Imag7 // 图 像 视图 
TextView title; // 标 题 视图 
TextView email; // 电 子 邮件 地 址 视图 
TextView address; // 住 址 视图 


1 


public View getView(int position, View convertView, ViewGroup 


parent) { // 实 现 获 取 视 图 方法 
ViewHolder holder; // 定 义 列表 项 视图 类 
if (convertView == null) { // 判 断 已 有 视图 是 否 为 空 


LayoutInflater mInflater = (LayoutInflater) context 
.getSystemService (Context.LRAYOUT INFLATER 


SERVICE) ; // 获 取 布 局 管理 器 
convertView = mInflater.inflate(R.layout.listviewitem, 
nul11); // 设 置 列表 项 布局 


holder = new ViewHolder (); // 实 例 化 列表 项 视图 类 
/** 实例 化 具体 的 控件 */ 
holder.Imag = (ImageView) convertView.findViewById(R.id. 
item image); 
holder.title = (TextView) convertView.findViewById(R.id. 
item title); 
holder.email = (TextView) convertView.findViewById(R.id. 
item email); 
holder.address = (TextView) convertView.findViewById(R.id. 
item address); 
convertView.setTag (holder); 

} else { 
holder = (ViewHolder) convertView.getTag(); 

} 


Contactinfo ctinfo = new Contactinfo(); // 实 例 化 联系 人 信息 类 
ctinfo = Ex contactsActivity.contactinfo list.get (position); 


// 获 取 联 系 人 信息 
holder. Imag. setImageBitmap (ctinfo.pho) ; // 在 视图 中 设置 联系 人 头像 
holder.title.setTexrt(ctinfo.tel name + " : "+ ctinfo.tel 
Phone); // 在 视图 中 设置 联系 人 姓名 
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29 holder .email.setText (ctinfo.email); 
// 在 视图 中 设置 联系 人 电子 邮件 地 址 
30 holder.address.setText (ctinfo.address); 
// 在 视图 中 设置 联系 人 地 址 
SS 
32 return convertView; // 返 回 列表 项 视图 
33 | 


其 中 ，01 一 07 行 ， 定 义 显示 视图 的 类 ViewHolder; 

08 一 23 行 ， 实 现 布 局 转化 为 视图 ， 并 初始 化 到 视图 类 ViewHolder 中 。11 一 13 行 ， 将 
Item 布局 装载 转化 为 视图 16 一 19 行 ， 实 例 化 控件 ，20 行 ， 设 置 与 该 视图 关联 的 标签 ， 
以 便 保存 ， 获 取 该 ViewHolder 视图 ; 22 行 ， 读 取 视 图 到 ViewHolder 中 ; 

24 一 33 行 ， 根 据 关 联 的 数据 来 设置 ListView 中 每 一 项 显示 结果 ， 效 果 如 图 4.54 所 示 。 


3. ListView 布 局 和 数据 关联 


由 于 主 界面 简单 ， 数 据 的 关联 实现 也 在 继承 的 My_Adapter 中 实现 ， 所 以 代码 很 少 ， 
具体 如 下 : 

my adapter = new My Adapter (context); 

mylist.setAdapter (my_adapter) 7 

4. 运行 分 析 总 结 


对 程序 进行 调试 运行 ， 显 示 的 结果 如 图 4.53 所 示 。 和 保存 在 系统 中 的 通讯 录 信 息 〈 如 
图 4.47 所 示 ) 是 一 致 的 。 总 结 获取 通讯 录 信 息 的 整个 过 程 ， 首 先 需 要 申请 访问 通讯 录 的 权 
限 ! 然后 根据 不 同 的 表 的 资源 地 址 进行 相应 的 查询 ， 记 录 各 个 表 中 查询 的 结果 ， 从 而 获得 
通讯 录 的 全 部 信息 ; 获得 了 所 有 信息 后 青 使 用 ListView 进行 显示 。 


本 章 介 绍 了 Android 中 的 4 种 数据 存储 方式 : SharedPreference、Files、SQLite 和 
NetWork。 对 于 每 一 种 存储 方式 都 通过 在 实际 项 目 中 使 用 的 示例 来 详细 讲解 。 其 中 重点 讲 
解 了 使 用 最 广泛 的 数据 库存 储 方式 ， 同 时 也 是 本 章 的 难点 。 并 且 对 在 应 用 程序 之 间 使 用 
Content Providers 来 统一 接口 以 实现 数据 共享 进行 了 实例 讲解 。 在 接 下 来 的 一 章 中 ， 我 们 
同样 通过 实例 来 详细 讲解 Android 中 网 络 通信 的 相关 内 容 。 





4.10 习 题 


【习题 1】 结 合 4.2 节 SharedPreferences 的 知识 ， 实 现 用 户 登 录 时 记 住 所 有 登录 的 用 
户 名 。 
名 提示: 在 SharedPreferences 中 保存 的 是 键 值 对 , 每 一 个 键 对 应 一 个 值 且 各 键 名 不 得 重复 ， 
为 了 获取 多 个 用 户 名 ,在 保存 时 可 以 将 多 个 用 户 名 以 特定 字符 进行 分 隔 。 对 于 输 
入 登录 名 的 输入 框 使 用 自动 提示 框 antoCompleteTextView。 
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关键 代码 : 
// 保 存 数 据 到 SharedPreferences 


private void savePreferences () { 
String qQString;//AutoCompleteTextView 控件 中 所 需要 数据 
SharedPreferences settings = getSharedPreferences (PREFS STRING, 
MODE PRIVATE); 
SharedPreferences.Editor editor = settings.edit(); 
NameString = settings.getSstring ("NAME", ""); 
if (!NameString.contains (autoCompleteTextView.getText (). 
tostring())) { 
// 保 证 不 会 有 重复 的 item 存 入 
NameString += "#" + autoCompleteTextView.getText() .tostring(); 
// 每 个 名 字 以 # 号 分 隔 ; 
//SharedPreferences 只 能 保存 基本 数据 类 型 ， 所 以 此 处 把 所 有 名 字 保 存 为 
String， 然 后 再 解析 成 item 数组 
editor.putstring("", qQSstring); 
} 
editor.commit (); // 记 得 提交 修改 
} 


// 从 SharedPreferences 读 取 数 据 
private void getPreferences() { 
String NameString; 
Be 
SharedPreferences settings = getSharedPreferences (PREFS STRING, 
MODE PRIVATE); 
qQString = settings.getSstring ("NAME", ""); 
String[] NameStrings = NameString.split("#"); 
// 从 读 出 的 String 中 解析 出 所 有 名 字 
ArrayAdapter<String> adapter = new ArrayAdapter<String> (this， 
android.R.layout.simple dropdown item lline, 
NameStrings); 
autoCompleteTextView.setAdapter (adapter); 
// 设 置 AutoCompleteTextView 的 内 容 
} catch (Exception e) { 
// TODO: handle exception 
} 
} 


【习题 2】 结合 4.3 节 SD 卡 文件 读 取 的 相关 内 容 ， 实 现 TXT 文本 阅读 器 的 功能 。 
全 提示 : 文件 的 读 取 方式 和 4.3 节 的 内 容 相似 ， 需 要 额外 考虑 大 文件 的 读 取 问 题 。 
关键 代码 : 


File file = new File("filename"); 
try { 
BufferedInputStream fis = new BufferedInputStream(new FileInput 
Stream( 
file), 10 * 1024 * 1024); // 用 10M 的 缓冲 读 取 
} catch (FileNotFoundException e) { 
e.printSstackTrace(); 


) 


【习题 3】 结合 4.4 节 数 据 库存 储 的 相关 内 容 ， 实 现 音乐 信息 的 数据 库存 储 以 及 其 增删 
改 查 操作 。 
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外 提示 : 音乐 信息 数据 库 和 4.4 节 的 学 生 信息 数据 库 是 类 似 的 ， 在 音乐 信息 数据 库 中 保存 
音乐 各、 歌手 名 、 发 行 时 间 和 所 属 专辑 。 





【习题 4】 结 合 4.7 节 数 据 共享 的 内 容 ， 实 现 对 音乐 信息 数据 库 的 共享 。 


全 提示 : 在 上 一 题 中 ， 我 们 实现 了 对 本 地 音乐 信息 数据 库 的 管理 ， 本 题 中 将 该 数据 库 进 行 
共享 让 其 他 程序 可 以 管理 该 数据 库 。 
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网 络 通信 是 交换 网 络 数据 的 手段 ， 它 可 以 让 人 们 浏览 网 页 、 收 发 电子 邮件 ， 进 行 视频 
通话 、 电 视 直 播 等 功能 。 不 止 在 PC 上 网 络 通信 必 不 可 少 ， 在 现代 手机 中 ， 网 络 通信 也 是 
一 个 重要 的 功能 。 在 Android 中 ， 人 们 同样 可 以 通过 网 络 通信 来 随时 随地 地 浏览 网 页 、 即 
时 聊天 、 收 发 微 博 等 。 本 章 主要 围绕 网 络 通信 中 的 主要 通信 方式 来 进行 实例 讲解 。 





5.1] 网 络 通信 方式 


Android 的 应 用 层 采 用 的 是 Java 语言 ， 所 以 Java 支持 的 网 络 编程 方式 Android 都 是 支 
持 的 ， 同 时 Android 还 引入 了 Apache 的 HTTP 扩展 包 ， 并 且 针对 WiFi、 蓝 牙 等 分 别提 供 
了 单独 的 开发 API。 因 此 ， 在 Android 平台 中 ， 总 共 提 供 了 3 种 网 络 接口 ， 它 们 分 别 是 : 
java.net.* (Java 标准 接口 ) 、org.apache (Apache 接口 ) 和 android.net.* (Android 网 络 





接口 ) 。 
其 中 : 
口 java.net.* (Java 标准 接口 ) ， 提 供 流 和 数据 包 套 接 字 、Intemet 协议 和 常用 HTTP 
处 理 。 该 包 是 一 个 功能 很 全 面 的 网 络 通信 包 ， 方 便 有 经 验 的 Java 开发 人 员 直 接 
使 用 。 
口 org.apache (Apache 接口 ) ， 为 HTTP 通信 提供 了 高 效 、 精 确 、 功 能 丰富 的 工具 包 
支持 。 


口 android.net.* (Android 网 络 接口 ), 提供 了 网 络 访问 的 Socket、URI 类 以 及 和 WiFi 
相关 的 类 ， 并 且 提 供 了 网 络 状态 监视 管理 等 接口 。 

有 了 这 些 工 具 包 的 支持 ， 在 Android 中 具体 使 用 的 儿 种 网 络 编程 方式 有 : 

(1) 针对 TCP/IP 的 Socket、ServerSocket。 

(2) 针对 UDP 的 DatagramSocket、DatagramPackage。 

(3) 针对 直接 URL 的 HttpURLConnection。 

(4) Google 集成 了 Apache HTTP 客户 端 ， 可 使 用 HTTP 进行 网 络 编程 。 

(5) 使 用 Web Service 进行 网 络 编程 。 

(6) 直接 使 用 WebView 视图 组 件 显示 网 页 。 

其 中 ,方式 1 和 方式 2 都 是 Socket 通信 方式 ,方式 3、4、5 是 HITP 通信 方式 ， 而 方 
式 6 是 Android 提供 的 网 页 浏览 控件 。 在 接 下 来 的 章节 中 ， 我 们 将 针对 这 几 种 不 同 的 网 络 
编程 方式 以 及 WiFi 和 蓝牙 进行 讲解 。 
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$.2 ”Android 控制 PC 关机 


远程 控制 是 一 项 非常 实用 的 功能 ， 可 以 通过 网 络 远程 控制 PC， 访 问 其 图 片 、 音 乐 、 视 
频 等 。 传 统 意义 的 远程 控制 一 般 指 在 一 台 PC 上 能 操控 另 一 台 PC， 而 现在 我 们 可 以 通过 
Android 来 达到 远程 控制 PC 的 效果 。 这 一 节 中 ， 我 们 将 通过 使 用 TCP/IP 的 Socket 连接 来 
实现 Android 控制 PC 关机 。 

Socket 通常 称 为 “ 套 接 字 ”， 用 来 描述 IP 地 址 和 端口 ， 应 用 程序 通过 其 向 网 络 发 送 请 
求 和 应 答 请 求实 现 网 络 通信 。Socket 有 两 种 主要 的 操作 方式 : 面向 连接 的 和 无 连接 的 。 

本 实例 中 使 用 面向 连接 的 Socket 通信 。 在 此 模式 下 ，Socket 必须 在 发 送 数据 之 前 和 目 
的 地 的 Socket 建立 好 连接 。 所 以 ， 该 模式 下 的 通信 ， 服 务 器 端 首先 启动 侦 听 服务 ， 等 待 客 
户 端的 连接 。 客 户 端 连接 到 服务 器 端 后 发 送 请 求 到 服务 服务 器 端 客户 端 
器 端 , 服务 器 端 处 理 请 求 并 做 出 相应 的 应 答 , 实现 通信 ， 连接 _ 


流程 如 图 5.1 所 示 。 初始 化 初始 化 
Server Socket 人 








5.2.1 PC 服务 器 端 等 竺 窗户 奖 一 一人 过 放 求 

PC 的 IP 地 址 相对 固定 ， 作 为 服务 器 端 ， 需 要 完成 
服务 器 端的 TCP 通信 流程 以 及 关闭 PC 的 操作 。 需 要 注 
意 的 是 ， 由 于 服务 器 端 是 运行 在 PC 的 程序 ， 我 们 需要 
创建 的 是 一 个 Java 的 标准 项 目 ， 而 不 是 Android 项 目 。 


1. 通信 过 程 


由 TCP 的 通信 流程 可 以 看 出 ,在 服务 器 端 需要 完成 
以 下 4 个 步骤 ， 

(1) 创建 服务 器 端 套 接 字 并 绑 定 到 一 个 端口 。 

在 Java 标准 接口 中 ， 提 供 了 两 个 类 : ServerSocket 和 Socket， 分 别 用 来 表示 服务 器 端 
和 客户 端 。 服 务 器 端的 ServerSocket 有 如 下 几 种 构造 函数 : 


ServerSocket () 

ServerSocket (int aport) 

ServerSocket (int aport, int backlog) 

ServerSocket (int aport, int backlog, InetAddress localAddr) 


其 中 ,参数 aport 指定 服务 器 要 绑 定 的 端口 即 服务 器 要 监听 的 端口 ， 参数 backlog 指定 
客户 连接 请 求 队列 的 长 度 ， 参 数 localAddr 指定 服务 器 要 绑 定 的 人 P 地 址 。 一 般 来 说 端口 号 
0 一 1023 是 系统 预 留 的 ， 我 们 使 用 的 端口 号 最 好 大 于 1024。 例 如 ， 创 建 一 个 监听 端口 号 为 
3333 的 服务 套 接 字 ， 代 码 如 下 : 

ServerSocket serversocket = new ServerSocket (3333) 7 

(2) 套 接 字 设置 监听 模式 等 待 连接 请 求 。 

创建 服务 套 接 字 后 ， 接 下 来 就 监听 端口 等 待 客户 端的 连接 ， 使 用 ServerSocket 类 的 


.184 . 





图 5.1 TCP 通信 流程 
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方法 : 

Socket accept () 

该 方法 是 一 个 阻塞 方法 ， 调 用 该 方法 后 将 一 直 监 听 端 口 等 待 客户 端的 请 求 ， 直 到 有 客 
户 端 连接 到 该 端口 ， 才 会 返回 一 个 对 应 于 客户 端的 Socket， 继 续 执行 之 后 的 代码 。 

(3) 接受 连接 请 求 后 进行 通信 。 

Socket 连接 建立 后 ， 服 务 器 端 和 客户 端 通过 Socket 的 输入 、 输 出 流 来 读 写 数据 ， 实 现 
通信 的 功能 。Socket 提供 的 如 下 方法 : 


InputStream getInputStream() 
OutputStream getOutputStream() 


分 别 返 回 用 于 读 取 数据 的 mputStream 类 对 象 和 用 于 写 入 数据 的 OutputStream 类 对 象 。 
为 了 方便 读 写 数 据 , 可 以 使 用 流 DataInputStream 和 DataOutputStream 类 ; 对 于 文本 流 对 象 ， 
可 以 使 用 InputStreamReader 和 OutputStreamReader 类 。 以 使 用 DataInputStream 类 读 取 输 
入 请 求 为 例 ， 代 码 如 下 : 

DataInputStream data input = new DataInputStream(client socket. 

getInputStream() ) ; 

String msg = data input.readUTF (); 

(4) 关闭 该 Socket 返回 ， 等 待 下 一 个 连接 请 求 。 

通信 完成 后 ， 需 要 将 输入 输出 流 以 及 Socket 关闭 ， 以 主动 释放 不 再 使 用 的 资源 。 

熟悉 了 整个 通信 过 程 以 及 关键 点 ， 下 面 来 实现 在 PC 上 运行 服务 器 端 ， 对 客户 端 输 入 
的 命令 进行 判断 ， 执 行 不 同 命令 对 应 的 关机 、 重 启 、 注 销 操作 。 具 体 代码 如 下 : 


01 static ServerSocket serversocket = null; // 服 务 socket 

02 static DataInputStream data input = null; // 输 入 流 

03 static DataOutputStream data output = null; // 输 出 流 

04 public static void main (String[] args) { 

05 try { 

06 // 创 建 套 接 字 ， 并 监听 

07 serversocket = new ServerSocket (3333); 

08 System.out.println("listening 3333 port"); 

09 

10 while (true) { 

1 // 获 取 客 户 端 套 接 字 

12 Socket client socket = serversocket.accept(); 

3 Ery 

14 // 获 取 输 入 流 ， 读 取 客户 端 传 来 的 数据 

LS data input = new DataInputStream(client socket. 
getInputStream() ) 

16 String msg = data input.readUTE () : 

了 System.out .println (msg) 7 

18 // 判 断 输入 ， 进 行 相应 的 操作 

19 if (msg.equals ("shutdown")) { 

20 Shutdown (); // 调 用 关机 方法 

ll } else if (msg.equals ("restart")) { 

22 Restart (); // 调 用 重启 方法 

23 } else if (msg.equals ("logoff")) { 

24 Logoff (); // 调 用 注销 登录 方法 

他 5 } 

26 } catch (Exception e) { 
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2 了 e-printStackTrace (); 

28 iinally { 

29 二 // 关 闭 连接 
30 data input .close(); 

3 client socket .close(); 
< } catch (IOException e) { 
33 e.printSstackTrace (); 
34 } 

3 } 

36 } 

37 } catch (Exception e) { 

38 e.printSstackTrace (); 

39 } 

40 

41 } 


其 中 ，01 一 03 行 ， 定义 全 局 使 用 的 ServerSocket、 输 入 输出 流 等 变量 ; 

04 行 ， 标 准 Java 程序 的 主 函 数 入 口 点 ; 

06 一 09 行 ， 创 建 一 个 用 于 监听 3333 端口 的 服务 Socket， 并 输出 提示 ; 

10 行 ， 一 个 永 真 的 循环 ， 使 程序 可 以 不 断 监听 连接 的 客户 端 ， 处 理 一 个 连接 后 等 待 下 
-个 连接 ; 

11 一 12 行 ， 监 听 端 口 ， 等 待 客户 端的 连接 ; 

13 一 17 行 ， 连 接 成 功 后 ， 获 取 输 入 流 ， 读 取 由 客户 端 发 送 来 的 请 求 数 据 ; 

18 一 25 行 ， 解 析 收 到 的 命令 数据 ， 根 据 不 同 的 命令 执行 相应 的 操作 ; 

29 一 31 行 ， 处 理 完 成 后 ， 关 闭 输入 流 以 及 套 接 字 。 


2. 关闭 PC 


现在 一 般 使 用 的 桌面 操作 系统 都 是 Windows 操作 系统 , 在 该 系统 中 我 们 可 以 调用 其 关 
机 程序 ， 即 用 shutdown 程序 来 实现 关机 。shutdown 程序 的 常用 参数 如 下 : 

-s 关闭 此 计算 机 

=- 关闭 并 重启 动 此 计算 机 

-1 注销 登录 用 户 

-a 放弃 系统 关机 

- xx 设置 关闭 的 超时 为 xx 秒 

在 Java 中 可 以 调用 运行 其 他 程序 进程 ， 通 过 java.lang.Runtime 类 的 方法 实现 : 

Process exec(String command) 

该 方法 返回 一 个 Process 对 象 ， 参 数 为 在 单独 的 进程 中 执行 指定 的 字符 串 命 令 。 例 如 ， 
实现 Windows 系统 的 关机 ， 代 码 如 下 : 


Runtime r = Runtime.getRuntime(); 
r.exec("shutdown -s"); 


掌握 了 关机 的 方法 后 ， 具 体 实现 关机 、 重 启 、 注 销 的 操作 代码 如 下 : 








01 // 关 机 

02 private static void Shutdown () throws IOException { 

03 Process P = Runtime .getRuntime () .exec("shutdown -s -t 60"); 
04 System-out -println("shutdown ,60 seconds later "); 

05 } 
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06 // 重 启 
07 private static void Restart() throws IOException { 
08 Process p = Runtime.getRuntime() .exec("shutdown -r -t 60"); 
09 System.out.println("restart ,60 seconds later "); 
10 } 
a // 注 销 
有 private static void Logoff () throws IOException { 
13 Process p = Runtime.getRuntime () .exec("shutdown -1 -t 60"); 
14 System.out.println ("logoff, 60 seconds later "); 
I | 
其 中 ，01 一 05 行 ， 实 现在 60s 后 自动 关机 ; TBT 
一 10 行 ， 实 现在 自动 重启 计算 机 , 
06 一 10 行 ， 实现 在 60s 后 自动 重启 计算 机 ; 
11 一 15 行 ， 实 现在 60s 后 注销 登录 的 用 户 。 ar oolE CA 


5.2.2 Android 控制 端 


Android 控制 端 作为 客户 端 ， 通 过 TCP 的 Socket 连接 
到 PC 服务 器 端 后 ,发送 控制 命令 到 服务 器 端 。 对 于 PC 端 
的 控制 有 关机 、 重启 和 注 销 3 种 操作 ， 所 以 在 Android 中 
设计 3 个 按钮 分 别 发 送 这 3 个 命令 ， 界 面 设计 如 图 5.2 所 
示 。 
对 于 客户 端 ， 实 现 TCP 通信 需要 如 下 步骤 : 
(1) 创建 客户 端 套 接 字 ， 指定 服务 器 端 他 地 址 与 端口 
客户 端 套 接 字 Socket 常用 的 套 接 字 有 以 下 几 种 构造 


Socket () 

Socket (String dstName, int dstPort) 

Socket (String dstName, int dstPort, InetAddress localAddress, int localPort) 
Socket (InetAddress dstAddress, int dstPort) 

Socket (InetAddress dstAddress, int dstPort, InetAddress localAddress, int 
localPort) 
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图 52 Android 控制 端 














其 中 ， 参 数 dstName 是 连接 到 的 主机 名 ，dstPort 是 连接 到 的 端口 号 ，dstAddress 是 连 
接 到 的 了 P 地 址 ， 而 localAddress 和 localPort 表示 本 地 机 器 的 地 址 和 端口 号 。 例 如 ， 连 接 到 
服务 器 3333 端口 ， 代 码 如 下 


Socket client socket = new Socket("10-.20.233-164"”，， 3333); 


当 创建 客户 端的 Socket 时 会 根据 指定 的 地 址 和 端口 号 ， 连 接 到 服务 器 端 。 

(2) 与 服务 器 端 进行 通信 

与 服务 器 端的 通信 同样 使 用 输入 输出 流 InputStream 和 OutputStream 类 对 象 。 在 对 应 
的 按钮 被 单 击 后 ， 发 送 相应 的 命令 数据 。 

(3) 关闭 套 接 字 

通信 完成 后 ， 同 样 需 要 将 输入 输出 流 以 及 Socket 关闭 ， 主 动 释放 这 些 资源 。 熟 悉 了 客 
户 端的 流程 ， 实 现 Android 控制 端的 代码 如 下 : 




















01 Public void onClick(View v) { 
02 // 连 接 服务 器 
03 ty 


7 


实战 Android 应 用 开发 








04 client socket = new Socket("10.20.233.164", 3333); 
// 新 建 Socket 连接 
05 data output = new DataOutputStream(client socket. 
getOutputStream() ) 7 // 获 取 数 据 输 出 流 
06 data input = new DataInputStream(client socket -. 
getInputStream() ) // 获 取 数 据 输入 流 
必 流 } catch (Exception e) { 
08 e.printstackTrace (); 
09 } 
10 
1 String text = ""; // 传 输 的 内 容 
下 有 switch (v.getId()) { 
TS case R.id.shutdown: // 单 击 “ 关 机 ”按钮 
14 text = "shutdown"; 
ho» break; 
16 case R.id.restart: // 单 击 “ 重 启 ” 按 钮 
py! text = "restart"; 
18 break; 
19 case R.id.logoff: // 单 击 “ 注 销 登录 ”按钮 
20 text = "logoff"; 
21 break; 
区 这 default: 
| break; 
24 } 
YY 4 
26 if ((data output != null) && (!text.equals(""))) { 
27 data output.writeUTF (text); // 传 输 命 令 
28 data output.close(); // 关 闭 数据 输出 流 
29 client socket.close(); // 关 闭 Socket 连接 
30 } 
3 } catch (Exception e) { 
2 e.printStackTrace (); 
33 } 
34 } 


其 中 ,02 一 09 行 ,创建 客户 端 套 接 字 , 自动 连接 到 IP 地 址 为 10.20.233.164 的 端口 3333， 
即 服务 器 端 监 听 的 端口 。 需 要 注意 的 是 IP 地址 使 用 服务 器 端的 地 址 ,常用 的 测试 回环 地 址 
127.0.0.1 代表 的 是 Android 模拟 器 的 地 址 ， 不 是 PC 的 地 址 ; 

11 一 24 行 ， 根 据 不 同 的 按钮 ， 分 别 发 送 命令 数据 shutdown、restart 和 logoff; 

25 一 27 行 ， 通 过 输出 流 将 数据 发 送 到 服务 器 端 ; 

28 一 29 行 ， 关 闭 不 再 使 用 的 输出 流 data_output 和 套 接 字 client_socket。 

在 Android 中 使 用 网 络 需 要 在 AndroidManifest.xml 文件 中 申请 权限 ， 代 码 如 下 


<uses-permission 
android:name="android.permission.INTERNET"></uses-permission> 





5.2.3 ”运行 分 析 总 结 


先 运行 服务 器 端 ， 在 输出 listening 3333 port 后 ， 等 待 客户 端的 连接 。 此 时 ， 开 启 客户 
端 ， 如 图 5.2 所 示 ， 单 击 “ 注 销 登录 ”按钮 ， 发 送 全 令 到 服务 器 端 。 在 服务 器 端的 输出 中 
可 以 看 到 发 送 的 信息 logoff， 并 在 60s 后 ，Windows 关闭 所 有 应 用 程序 ， 注 销 登录 。 在 服 
务 器 端的 输出 如 图 5.3 所 示 。 
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logoff, 60 seconds later 


图 5.3 服务 器 端的 输出 





在 基于 TCP 的 Socket 通信 中 ， 服 务 器 端 需要 一 直 等 待 客户 端的 连接 ， 所 以 需要 在 一 
个 死 循 环 中 等 竺 连接 。 当 有 多 个 客户 端 需要 连接 到 服务 器 端 时 ， 服 务 器 端 应 该 开启 新 的 线 
程 来 完成 通信 处 理 。 


5.3 Android 即时 聊天 


人 们 可 以 不 受 地 域 的 限制 , 通过 网 络 来 进行 即时 的 聊天 。 现在 有 优秀 的 即时 聊天 工具 ， 
如 手机 QQ、 米 聊 、 飞 聊 等 。 在 这 一 节 中 ， 我 们 将 使 用 UDP 的 Socket 来 实现 Android 间 的 
即时 聊天 功能 。 

该 方式 是 无 连接 的 Socket 通信 ， 所 以 不 需要 像 TCP 那样 先 建立 连接 再 发 送 数据 ， 可 
以 直接 对 目标 地 址 发 送 数据 。 这 样 的 方式 更 加 快速 和 高 效 ， 但 是 不 能 保证 数据 能 够 完全 到 
达 目 标 端 ， 通 信 流 程 如 图 5.4 所 示 。 

作为 一 个 即时 聊天 的 软件 ， 软 件 本 身 既 是 服务 器 端 用 于 接收 对 方 发 来 的 数据 ， 又 是 客 
户 端 用 于 发 送 数 据 到 对 方 。 通信 过 程 中 ,需要 明确 数据 发 送 到 目标 的 他 地 址 、 端 口 以 及 需 
要 发 送 的 数据 ， 同 时 需要 保存 已 有 的 通话 记录 ， 界 面 设计 如 图 5.5 所 示 。 


ml pon 


Ex udp chat 














服务 器 端 客户 端 
UDP 连接 
初始 化 初始 化 
DatagramSocket DatagramSocket 
| | 
应 答 响应 
| | 
关闭 连接 关闭 连接 
图 5.4 UDP 通信 流程 图 5.5 聊天 界面 
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和 TCP 中 一 样 , Android 中 需要 使 用 网 络 必须 在 AndroidManifestxml 文件 中 申请 权限 
代码 如 下 : 


<uses-permission android:name="android.permission.INTERNET"></uses-— 
permission> 





5.3.1 Android 接收 端 











Android 的 接收 端 即 是 服务 器 端 ， 主 要 用 于 开局 端口 、 等 待 客户 端的 数据 和 输入， 并 且 
将 接收 到 的 数据 显示 在 界面 中 。 接 下 来 , 我 们 将 实现 数据 的 接收 并 通知 更 新 界面 显示 数据 。 


1. 通信 过 程 








UDP 通信 相对 TCP 通信 而 言 比较 简单 ， 不 需要 事先 建立 连接 ， 只 需要 创建 一 个 接收 
和 发 送 的 套 接 字 便 可 以 实现 数据 的 处 理 和 发 送 。 在 服务 器 端 实现 需要 如 下 几 个 步骤 : 

(1) 创建 套 接 字 并 绑 定 到 一 个 端口 

在 UDP 中 使 用 套 接 字 DatagramSocket 来 表示 数据 的 接收 站 和 发 送 站 。 常 用 的 构造 函 
数 如 下 : 

DatagramSocket () 

DatagramSocket (int aPort) 

DatagramSocket (int aPort, InetAddress addr) 

DatagramSocket (SocketAddress localAddr) 

其 中 ，aPort 是 本 地 绑 定 的 端口 号 ，InetAddress 是 指定 的 地 址 ，SocketAddress 表明 绑 
定 到 特定 的 套 接 字 地 址 。 例 如 ， 创 建 一 个 监听 端口 号 为 3000 的 UDP 套 接 字 ， 实 现 如 下 : 

DatagramSocket = new DatagramSocket (3000) 

(2) 接收 数据 

有 了 和 套 接 字 后 ， 我 们 就 可 以 直接 使 用 它 来 接收 数据 ， 使 用 DatagramSocket 类 的 方法 : 

receive (DatagramPacket pack) 

其 中 ， 参 数 pack 是 DatagramPacket 类 型 ， 表 示 存 放 数 据 的 数据 包 。 

(3) 处 理 数据 

无 论 是 发 送 还 是 接收 的 数据 都 以 DatagramPacket 类 型 来 表示 ， 处 理 数据 之 前 必须 构造 
此 类 ， 但 是 接收 数据 包 和 发 送 数据 包 是 有 区 别 的 。 常 用 接收 数据 构造 函数 有 : 

DatagramPacket (byte[] data, int length) 

其 中 ， 参 数 data 为 接收 的 数据 ，length 为 数据 的 长 度 。 例 如 ， 创 建 一 个 可 以 存放 1024 
字 节 数据 的 接收 数据 包 ， 实 现 如 下 : 


byte buf[] = new byte[1024]; 
DatagramPacket dp = new DatagramPacket (buf, 1024); 


常用 的 发 送 数据 的 构造 函数 有 : 


DatagramPacket (byte[] data, int length, InetAddress host, int port) 
DatagramPacket (byte[] data, int length, SocketAddress sockAddr) 
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其 中 ， 参 数 data 为 发 送 的 数据 ，length 为 数据 的 长 度 ，InetAddress 为 发 送 到 的 目标 地 
址 ，port 为 发 送 到 的 目标 端口 ，SocketAddress 为 发 送 到 的 指定 的 套 接 字 地 址 。 在 
DatagramPacket 类 中 可 以 获取 该 包 发 送 地 的 瑟 地 址 、 端 口 、 套 接 字 地 址 以 及 数据 内 容 ， 分 


别 使 用 如 下 方法 : 


InetAddress getAddress () 

Int getPort () 

SocketAddress getSocketAddress() 
byte[] getData() 


熟悉 了 整个 接收 数据 的 过 程 和 关键 点 ， 具 体 的 实现 如 下 : 


// 服 务 器 端 ， 接 收 消息 
Public void Chat init(final Handler handler) { 


} 


try { 
ds = new DatagramSocket (3000); // 端 口号 为 3000 
} catch (Exception ex) { 
ex.printStackTrace (); 
} 
new Thread(new Runnable() { 
public void run() { 


byte buf[] = new byte[1024]; // 数 据 缓存 
DatagramPacket dp = new DatagramPacket (buf, 1024); 
// 新 建 数据 包 
while (true) { 
try { 
ds .receive (dp); // 接 收 数据 包 
String text = "\n 来 自 " + dp.getAddress(). 
getHostAddress () 
+ "的 消息 : \n" + new String(buf, 0, dp. 
getLength ()); // 获 取 数 据 


System.out .println (text); 
Message message = new Message (); // 新 建 消息 类 
Bundle bundle = new Bundle () 
bundle.putString ("text"，text) ;7V/ 
message.setData (bundle) ;// 设 置 消息 类 包含 的 内 容 
handler.sendMessage (message) : 
// 发 送 消息 ， 用 于 UI 更 新 
} catch (Exception e) { 
e.printStackTrace () 7 
} 


} 
} 
1) .start(); 


其 中 ，03 一 07 行 ， 创 建 一 个 监听 端口 号 为 3000 的 UDP 套 接 字 ， 用 于 接收 数据 包 ; 

08 一 09 行 ， 开 启 一 个 新 的 线程 来 接收 数据 ， 为 了 将 Android 界面 处 理 与 接收 数据 过 程 
的 死 循 环 隔离 ， 防 止 UI 界面 卡 死 而 不 能 操作 ; 

10~11 行 ， 创 建 一 个 可 接收 数据 1024 字 节 的 DatagramPacket 来 处 理 数据 ; 


内 容 ; 








12 一 17 行 ， 从 套 接 字 DatagramSocket 中 接收 数据 包 dp， 获 取 数 据 包 的 发 送 地 址 和 
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18 一 22 行 ， 接 收 数据 线程 与 UI 线程 通信 ， 将 接收 到 的 数据 传 给 UI 线程。 
2. UI 界面 更 新 
在 Android 中 ， 其 相关 的 视图 和 控件 不 是 线程 安全 的 ， 也 就 是 说 只 有 原来 创建 视图 的 


线程 可 以 修改 更 新 这 些 视 图 。 所 以 必须 通过 线程 间 的 通信 来 通知 UI 线程 更 新 界面 。 在 这 
里 使 用 前 面 章节 介绍 过 的 Handler 方式 进行 线程 通信 。 上 面 程序 化 代码 中 接收 数据 线程 中 
的 18 一 22 行 已 经 实现 了 线程 间 数 据 的 传递 ， 下 面 实现 UI 界面 的 更 新 。 


中 


在 UI 界面 更 新 中 只 需要 将 收 到 的 信息 在 消息 记录 中 显示 ， 即 将 消息 添加 到 消息 记录 
实现 代码 如 下 : 


01 my handler=new Handler (){ 
02 QOverride 
03 public void handleMessage (Message msg) { 

// 处 理 通信 线程 传递 的 消息 
04 super.handleMessage (msg) 
05 String text=msg.getData() .getString("text") 

// 获 取 Message 的 内 容 
06 display.getText() .append (text) ;// 添 加 内 容 到 消息 记录 中 
07 } 
08 由 


其 中 ，05 行 ， 获 得 Message 中 的 显示 数据 ;06 行 ， 将 数据 添加 到 消息 记录 中 。 


5.3.2 Android 发 送 端 


在 UDP 中 ， 发 送 数据 和 接收 数据 的 流程 类 似 ， 都 是 通过 套 接 字 DatagramSocket 发 送 


或 接收 数据 DatagramPacket。 实 现 需要 如 下 几 步 : 


(1) 创建 套 接 字 DatagramSocket。 和 接收 端 完全 一 致 ， 在 本 聊天 示例 中 ， 使 用 同一 个 


DatagramSocket; 


法 。 


(2) 发 送 数据 DatagramPacket; 
在 发 送 端 ， 必 须 指定 数据 包 发 送 到 的 目标 地 址 和 端口 ， 使 用 DatagramPacket 的 构造 方 
例如 ， 数 据 包 目标 地 址 为 下 值 、 端 口 为 3000 的 数据 ， 实 现代 码 如 下 : 


DatagramPacket dp = new DatagramPacket (buf, buf.length, InetAddress. 
getByName (ip), 3000); 


数据 构造 好 后 ， 使 用 DatagramSocket 的 发 送 数据 方法 : 
send (DatagramPacket pack) 
熟悉 了 整个 数据 发 送 的 过 程 和 关键 ， 具 体 的 发 送 实现 如 下 : 


01 public void onClick(View v) { 


02 String ip = ip edtext.getText() .上 toString() : // 获 取 输 入 的 IP 地 址 

03 String port = port edtext.getText() .toString() ;// 获 取 输 入 的 端口 号 

04 String msg = content.getText() .上 toString() : // 获 取 输 入 的 消息 

05 

06 if ((ip.equals("")) 11 (port.equals("")) || (msg.equals(""))) { 
// 判 断 输 入 是 否 正确 

07 Toast -makeText (context， "请 输入 对 方 的 IP 地 址 和 端口 号 以 及 需要 发 送 的 
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消息 号 1000) .show() 


08 return; 

09 | 

10 display.getText () .append("\n 本 机 发 送 到 "+ip+" 的 信息 为 : \n"+msg); 
// 添 加 聊天 记录 

二 byte[] buf; 

12 buf = msg.getBytes () : // 消 息 复制 到 缓存 中 

13 try { 

14 DatagramPacket dp = new DatagramPacket (buf, buf.length, 

15 InetAddress .getByName (ip), Integer.valueOf (port)); 
// 构 造 数据 包 

16 ds.send (dp); // 发 送 数 据 包 

nh } catch (Exception ex) { 

18 ex.printSstackTrace (); 

19 } 

20 content .setText (""); // 输 入 消息 重 置 为 空 

21° 


其 中 ，01 一 09 行 ， 获 取 输 入 的 目标 人 P 地 址 、 端 口号 以 及 发 送 的 内 容 ， 并 判断 这 些 内 


容 是 否 为 空 ， 当 任 一 为 空 时 ， 提 示 用 户 输入 相应 的 数据 ; 
11 一 12 行 ， 将 输入 发 送 的 内 容 复 制 到 发 送 缓冲 区 中 ; 


13 一 15 行 ， 根 据 输入 的 目标 下 地址 、 端 口号 以 及 发 送 内 容 ， 构 造 发 送 的 数据 包 dp; 


16 行 ， 通 过 套 接 字 ds 将 数据 包 dp 发 送 到 目标 地 址 。 
5.3.3 ”运行 分 析 总 结 

1， 单 个 模拟 器 测试 

为 了 方便 ， 我 们 通过 Android 虚拟 机 本 身 的 回环 地 址 ， 


来 测试 是 否 实现 了 即时 聊天 的 功能 。 在 IP 地 址 栏 中 输入 
环 地 址 127.0.0.1, 端口 为 3000, 实现 聊天 结果 如 图 5.6 所 示 。 


2. 两 个 模拟 器 之 间 通 信 


在 同一 台 PC 上 启动 两 个 Android 模拟 器 : 模拟 器 1 
(emulator-5554) 和 模拟 器 2(emulator-5556) ， 这 两 个 模拟 
器 的 IP 地 址 是 一 样 的 10.0.2.3， 这 样 是 无 法 在 这 两 个 模 
拟 器 之 间 进 行 网 络 通信 的 。 如果 要 在 两 个 模拟 器 之 间 进 行 通 
和信， 需要 由 PC 做 端口 映射 。 步 又 如 下 : 

(1) 同时 启动 两 个 Android 模拟 器 

如 图 5.7 所 示 , 单 击 Eclipse 中 工具 栏 中 机 器 人 头像 (图 
5.7 中 左上 角 圈 出 ) ， 弹 出 Android SDK and AVD Manager 
对 话 框 ， 开 启 两 个 模拟 器 。 如 果 没 有 两 个 模拟 器 ， 则 新 建 一 
个 再 开启 。 

(2) Android 模拟 器 中 的 端口 重 定向 


加 























所 示 。 





pppe acno, 


ED 


本 机 发 送 到 127.0.0.1 的 信息 为 ; 
test 
来 自 127.0.0.1 的 消 


test 
本 机 发 送 到 127.0.0.1 的 信息 为 : 
你 好 


来 自 127.0.0.1 的 消息 : 
你 好 


127.0.0.1 3000 


图 5.6 自身 聊天 


在 Windows 的 cmd 窗口 中 ， 执 行 adb devices， 查 看 两 个 设备 是 否 启 动 好 ， 如 图 5.8 
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图 5.7 同时 开启 两 个 模拟 器 





图 5.8 ”查看 模拟 器 设备 

启动 完成 后 , 我 们 对 emulator-5554 进行 端口 映射。 在 窗口 下 执行 telnet localhost 5554， 
连 上 模拟 器 emulator-5554。 成 功 连接 后 ， 继 续 执行 redir add udp:4000:3000。 这 样 就 将 所 有 
在 PC 上 4000 端口 的 udp 通信 都 重 定向 到 Android 模拟 器 的 3000 端口 上 。 添 加 成 功 后 ， 
可 以 用 redir list 命令 来 列 出 已 经 添加 的 映射 端口 ， 使 用 redir del 命令 可 以 进行 删除 。 

同 理 ， 对 emulator-5556 进行 端口 映射 ， 将 PC 的 4321 端口 映射 到 模拟 器 的 3000 端 
LE; 

telnet localhost 5556 

redir add udp:4321:3000 

(3) 通信 测试 

完成 了 端口 映射 之 后 就 可 以 在 两 个 模拟 器 之 间 进 行 网 络 通信 了 。 不 过 , 通信 的 他 地址 
为 PC 的 他 地 址 ， 端 口号 为 PC 的 映射 端口 号 。 即 在 本 例 中 ， 与 5554 通信 ， 其 通信 卫 地 
址 为 PC 地 址 10.20.233.164， 端 口号 为 4000; 5556 的 卫 地址 为 10.20.233.164， 端 口号 为 
4321。 读 者 在 实际 操作 中 ， 以 自己 PC 的 下 地 址 以 及 映射 端口 为 准 。 

由 5556 发 送 hello 到 5554， 然 后 5554 回答 发 送 “ 你 好 ”到 5556。 这 样 就 实现 了 在 两 
个 Android 设备 之 间 的 即时 聊天 ， 效 果 如 图 5.9 所 示 。 








本 机 发 送 到 10.20.233.164 的 信息 为 : 采 让 10.20.233.164 的 消息 : 

hello ello 

末 自 10.20.233.164 的 消息 本 机 发 送 到 10.20.233.164 的 信息 为 : 
你 好 你 好 





图 5.9 ”模拟 器 之 间 聊 天 


. 194 . 


第 5 章 ” Android 网 络 通信 

















UDP 的 通信 流程 比较 简单 ， 就 是 使 用 套 接 字 DatagramSocket 来 发 送 或 接收 数据 
DatagramPacket 的 过 程 。 需 要 注意 的 是 ， 数 据 包 DatagramPacket 在 发 送 和 接收 时 的 构造 是 
不 一 样 的 。 





5.4 查询 手机 归属 地 


我 们 经 常会 收 到 陌生 号 码 的 短信 或 者 被 陌生 的 电话 号 码 内 了 一 下 电话 ， 这 个 时 候 我 们 
可 以 通过 上 网 来 查询 该 号 码 的 归属 地 等 基本 信息 。 在 这 一 节 中 ， 我 们 将 实现 查询 手机 号 码 
归属 地 的 示例 。 本 示例 通过 HttpURLConnection 方式 来 访问 网 络 ， 查 询 手机 号 码 的 基本 
信息 。 

最 常用 的 http 请 求 分 为 GET 和 POST 两 类 。GET 请 求 可 以 获取 静态 页 面 ， 也 可 以 把 
参数 放 在 URL 字 串 后 面 传递 给 服务 器 ; 而 POST 与 GET 的 不 同 之 处 在 于 POST 的 参数 不 
是 放 在 URL 字 串 里 面 ， 而 是 放 在 http 请 求 的 正文 内 。 在 Android 中 可 以 使 用 
HttpURLConnection 发 送 这 两 种 请 求 。 接 下 来 ， 我 们 分 别 通过 这 两 种 方式 来 获取 手机 号 码 
的 归属 地 等 基本 信息 。 

在 界面 中 ， 我 们 需要 输入 查询 号 码 的 输入 框 以 及 分 别 触发 这 两 种 查询 方式 的 按钮 ， 如 
图 5.10 所 示 。 在 实现 网 络 请 求 之 前 ， 必 须 在 AndroidManifestxml 文件 中 申请 权限 ， 如 下 : 


<uses-permission android:name="android.permission.INTERNET"> 
</uses-permission> 


5.4.1 GET 请 求 
Ex phone owner 

在 Adnroid 中 使 用 GET 方式 发 送 http 请 求 ， 使 用 

的 是 Java 的 标准 类 , 大 家 应 该 比较 熟悉 , 也 比较 简单 。 

通过 如 下 几 步 即 可 实现 ; 

1， 构造 URL 

在 访问 网 络 时 都 是 通过 URL 来 指定 目标 位 置 的 ， 

构造 一 个 URL 实例 ， 使 用 方法 : 

URL(String spec) 


GET 连 接 手机 在 线 API 成 功 ! 





其 中 ， 参 数 spec 是 URL 地 址 的 字符 串 。 需 要 注 
意 的 是 ， 由 于 使 用 的 是 GET 方式 发 送 请 求 ， 请 求 的 参 
数 是 放 在 URL 字 串 后 面 传递 给 服务 器 , 即 我 们 直接 访 。 E 
问 的 是 查询 结果 的 网 页 。 例 如 ， 在 百度 页 面 中 ， 搜 索 ”图 5.10 GET 方式 获取 手机 号 码 信息 
Android ， 搜 索 结 果 显 示 的 网 址 就 是 http://www. 
baidu.com / s?wd= Android。 因 此 ， 在 GET 中 访问 的 URL 地 址 就 应 该 是 http://www.baidu. 
com/s?wd= Android。 

在 本 示例 中 ， 通 过 查询 手机 在 线 提供 的 服务 来 查询 手机 号 码 归属 地 。 查 询 结果 的 地 址 
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为 http://api.showji.com/Locating/default.aspx?m**&output~xml。 其 中 ，“m=” 后 是 查询 的 
手机 号 码 。 以 查询 电话 号 码 为 1234567890 为 例 ， 构 造 URL 如 下 : 


URL geturl = new URL("http://api.showji.com/Locating/default.aspx?m= 
1234567890&output=xml "); 


2. 设置 连接 

在 URL 连接 中 ， 使 用 URLConnection 类 来 定义 一 个 连接 。 当 知道 了 访问 的 网 络 地 址 
后 ， 需 要 获取 一 个 URL 连接 实例 ， 使 用 URL 类 的 方法 : 

URLConnection openConnection () 

该 方法 返回 不 同 的 URLConnection 子 类 的 对 象 。 在 本 示例 中 URL 是 一 个 http 的 地 址 ， 
忆 此 实际 返回 的 是 HttpURLConnection。 此 时 ， 可 以 对 连接 进行 设置 。 在 GET 方式 中 ， 一 
般 只 设置 连接 超时 时 间 : 

Void setReadTimeout (int timeout) 

其 中 , 参数 为 超时 时 间 ， 以 毫秒 计算 。 对 于 是 否 已 经 连接 到 目标 地 址 , 通过 远程 HTTP 
服务 器 返回 的 响应 代码 来 进行 判断 。 获 取 响 应 代码 的 方法 如 下 : 

int getResponseCode() 

其 中 ， 返 回 值 为 响应 编号 。 经 常 使 用 的 有 : HTTP OK， 表示 已 经 连接 ， 
HTTP NOT FOUND， 表示 没有 找到 网 址 等 。 

3. 获取 返回 数据 

当 请 求 发 送 连接 成 功 后 ，HTTP 服务 器 将 会 将 应 答 数据 返回 输入 流 中 。 我 们 使 用 
InputStreamReader 来 读 取 返回 的 数据 。 获 取 返 回 的 输入 流 ， 使 用 HttpURLConnection 类 的 
方法 : 

InputStream getInputStream() 

其 中 ,返回 值 是 一 个 输入 流 。 由 于 网 页 采用 的 是 UTF-8 的 编码 方式 ， 所 以 在 读 取 返 回 
的 输入 流 时 ， 使 用 方法 : 

InputStreamReader (InputStream in, String enc) 

其 中 ， 参 数 enc 为 编码 方式 。 这 里 ， 使 用 UTF-8 编码 。 

4. 关闭 连接 


实现 方法 是 : 

void disconnect () 

我 们 已 经 熟悉 了 整个 GET 方式 发 送 请 求 的 过 程 , 下 面 来 看 看 使 用 这 种 方式 来 查询 获取 
号 码 基本 信息 的 具体 实现 代码 : 

01 final static String phoneUrl="http://api.showji.com/Locating/default.aspx"; 


02 ”// 使 用 GET 连接 查询 
03 private void Get url() { 
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04 try { 

05 // 拼 竣 URL 地 址 

06 String phonenum = edt input.getText() .toString(); 

07 phonenum = phonenum.replace(™ ", "$20"); 
// 获 取 输 入 的 号 码 ， 蔡 换 输入 的 空格 

08 URL geturl = new URL( phoneUrl+"?m="+phonenum+"g&output=xm]l"); 
// 构 造 查 询 地 址 

09 HttpURLConnection httpconn = (HttpURLConnection) geturl. 

openConnection(); // 获 取 连 接 

10 httpconn.setReadTimeout (10000); // 设 置 超时 时 间 

了 if (httpconn.getResponseCode() 一 HttpURLConnection.HTTP OK) { 
// 连 接 获 取 成 功 

12 Toast .makeText (getApplicationContext (), "GET 连接 手机 在 线 

API 成 功 !"，1000) .show(); 
3 //InputStreamReader 获得 返回 的 数据 流 
14 InputStreamReader isr = new InputStreamReader (httpconn. 
getInputStream()， "utf-8"); 

5 int i; 

16 String content = " "7 

3 //read 读 取 获得 的 数据 

18 while ((i = isr.read()) != -1) 1{ 

L9 content = content + (char) i; // 从 数据 流 中 读 取 数据 

20 } 

2 isr.close(); // 关 闭 数据 流 

22 // 设 置 TextView 

23 tv _ result.setText (content); 

24 } 

25 // 关 闭 连 接 

26 httpconn.disconnect (); 

1 } catch (Exception e) { 

28 Toast.makeText (getApplicationContext () ，"GET 连接 手机 在 线 API 

失败 ",1000) .show() ; 

29 e.printStackTrace (); 

30 } 

< le 


其 中 ，01 行 ， 查 询 手 机 号 码 信息 的 基本 网 址 ， 用 于 与 需要 查询 的 手机 号 码 的 拼接 ， 从 
而 形成 正确 的 查询 地 址 ; 

05 一 08 行 ， 构 造 URL。 根 据 具 体 的 查询 号 码 ， 对 访问 URL 进行 构造 。 地 址 中 的 m= 
后 接 的 是 查询 的 手机 号 码 ，output=xml 表示 返回 的 查询 网 页 格式 为 XML 文件 格式 ; 

09 一 10 行 ， 对 连接 实例 HttpURLConnection 进行 获取 并 设置 ; 

11 行 ， 对 连接 状态 进行 判断 ， 当 连接 成 功 后 ， 获 取 返 回 的 数据 ; 

14 一 21 行 ， 读 取 返 回 数据 ; 

26 行 ， 获 取 数 据 后 ， 关 闭 连接 。 








5.4.2 POST 请 求 
POST 方式 相对 GET 方式 而 言 要 复杂 一 些 。 因 为 该 方式 需要 将 请 求 的 参数 放 在 http 请 


求 的 正文 内 ， 所 以 需要 构造 请 求 的 报 文 。POST 方式 进行 的 步骤 和 GET 方式 相同 ， 只 是 需 
要 对 连接 进行 更 多 的 设置 。 步 又 如 下 : 
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1. 构造 URL 


方法 和 GET 的 方法 是 一 样 的 ， 不 过 URL 地 址 是 不 带 参 数 的 。 依 旧 以 在 百度 页 面 中 搜 
索 Android 为 例 ， 此 时 的 URL 地 址 为 百度 的 网 址 http://www.baidu.com。 本 实例 访问 的 
URL 为 : 

URL geturl = new URL("http://api.showji.com/Locating/default.aspx "); 

2. 设置 连接 

在 GET 方式 中 ,获取 连接 类 URLConnection 后 ， 使 用 了 URLConnection 的 默认 设置 ， 
不 需要 再 对 设置 进行 修改 ， 而 在 POST 方式 中 ， 需 要 更 改 的 设置 如 下 : 


setDoOutput (true) 
setDoInput (true) 


这 两 个 方法 分 别 用 来 设置 是 否 向 该 URLConnection 连接 输出 和 输入 。 由 于 在 POST 请 
求 中 ， 查 询 的 参数 是 在 http 的 正文 内 ， 所 以 需要 进行 输入 和 输出 。 因 此 ， 将 这 两 个 方法 设 
置 为 true。 

setRequestMethod ("POST") 

该 方法 用 来 设置 请 求 的 方式 ， 默 认为 GET 方式 ， 需 要 将 其 设置 为 POST 方式 。 

setUseCaches (false) 

该 方法 用 来 设置 是 否 使 用 缓存 ， 在 POST 请 求 中 不 能 使 用 缓存 ， 将 其 设置 为 false。 

setRequestProperty ("Content-Type", "application/x-www-form-urlencoded") 

该 方法 用 来 设置 请 求 正文 的 类 型 。 由 于 我 们 在 正文 内 容 中 使 用 URLEncoder.encode 来 
进行 编码 ， 所 以 设置 如 上 ， 表 示 正 文 是 urlencoded 编码 过 的 form 参数 。 

完成 这 些 设置 后 ， 就 可 以 连接 到 远程 URL， 使 用 方法 : 

connect () 

3. 写 入 请 求 正文 

在 POST 方式 中 ， 需 要 将 请 求 的 内 容 写 在 请 求 正文 中 发 送 到 远程 服务 器 。 首 先 需要 获 
取 连 接 的 输出 流 ， 使 用 方法 : 

OutputStream getOutputstream() 

获取 了 输出 流 后 ， 需 要 将 参数 写 入 该 输出 流 中 。 写 入 的 内 容 和 GET 方式 中 的 URL 中 
“3?” 后 的 参数 字符 串 是 一 致 的 。 需 要 注意 的 是 ， 对 于 从 输入 框 中 输入 的 查询 电话 号 码 必须 
进行 URL 编码 。 例 如 ， 在 本 实例 中 ， 写 入 的 内 容 如 下 : 

String content = "m="+URLEncoder -encode (phonenum, "utf-8")+"g&output=xm]l"; 

4. 读 取 返 回 数据 、 关 闭 连 接 


完成 数据 的 请 求 后 ， 读 取 返 回 数据 和 关闭 连接 的 方法 与 GET 请 求 方式 是 一 样 的 。 
此 , 通过 与 GET 请 求 方式 的 对 比 ， 我 们 熟悉 了 POST 方式 发 送 请 求 的 整个 流程 ， 下 
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面 看 看 使 用 POST 方式 查询 获取 手机 号 码 基 本 信息 的 具体 代码 : 


01 


final static String phoneUrl="http://api.showji.com/Locating/ 
default .aspx"; 


private void Post url() { 
String phonenum = edt input.getText() .toString(); 


| 


// 获 取 输 入 的 号 码 
URL url = new URIL (PhoneUr1) : // 构 造访 问 地 址 
HttpURLConnection urlConn = (HttpURLConnection) url. 
openConnection(); // 获 取 连 接 
// 因 为 这 个 是 POST 请 求 , 所 以 需要 设置 为 true 
urlConn.setDoOutput (true) // 设 置 输出 
urlConn.setDoInput (true) // 设 置 输入 
// 设 置 超时 时 间 
urlConn.setReadTimeout (10000) 
// 设 置 以 POST 方式 
urlConn.setRequestMethod ("POST"); 
//POST 请 求 不 使 用 缓存 


urlConn.setUseCaches (false) : 

urlConn.setInstanceFollowRedirects (上 true) : 

// 配 置 本 次 连接 的 Content-type， 配 置 为 application/x-www-form- 
urlencoded 的 

urlConn .setRequestProperty ("Content-Type","application/ 

X-Www-Eorm-urlencoded'") : 

urlConn .connect (); // 连 接 


//DataoutputStream 输出 流 
DataOutputStream out = new DataOutputStream(urlConn. 
getOoutputStream()); 
// 要 上 传 的 参数 内 容 
String content = "m="+URLEncoder .encode (phonenum, 
"utf-8")+"&output=xml"; 
// 将 要 上 传 的 内 容 写 入 流 中 
out .writeBytes (content); 
// 刷 新 、 关 闭 
out-flush()? 
out.close(); 
InputStreamReader isr = new InputStreamReader (urlConn. 
getInputStream()); 
Trt 
String content post = ""; 
// 从 返回 数据 流 中 获取 数据 
while ((i = isr.read()) != -1) { 
content post = content post + (char) i; 





1 


isr.close(); 

// 设 置 TextView 

tv _ result.setText (content post); 

// 关 闭 http 连接 

UrlConn.disconnect() 

Toast -makeText (getApplicationContext () ，"POST 连接 手机 在 线 
API 成功",1000) -show () 


} catch (Exception e) { 


Toast -makeText (getApplicationContext() ，"POST 连接 手机 在 线 
API 失败 ",1000) -show () : 
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46 e.printstackTrace (); 

47 } 

48 } 

其 中 ，01 行 ， 是 查询 手机 号 码 信息 的 URL 地 址 ; 

05 一 06 行 ， 构 造 URL， 直 接 使 用 查询 信息 的 网 址 ; 

07 一 20 行 ， 获 取 连 接 实例 HttpURLConnection 并 进行 POST 相关 设置 。 注 意 设置 了 连 
接 的 是 否 允 许 输入 输出 、 超 时 时 间 、 请 求 方式 、 是 否 使 用 缓存 以 及 内 容 编码 类 型 等 ; 

22 一 30 行 ， 构 造 上 次 的 请 求 内 容 并 发 送 该 请 求 ; 

31 一 40 行 ， 读 取 返 回 的 数据 ， 并 显示 在 界面 中 ; 

42 行 ， 完 成 获取 数据 后 ， 关 闭 连接 ， 效 果 如 图 5.11 所 示 。 





5.4.3 ”显示 结果 


在 前 面 获取 的 数据 中 ， 无论 是 通过 GET 方式 还 是 POST 方式 ， 获 得 的 都 是 XML 文件 
格式 的 数据 ， 直 接 显示 给 用 户 查 看 ， 如 图 5.10 和 图 5.11， 明 显 是 不 友好 的 。 这 一 节 中 ， 
们 将 实现 解析 这 样 的 XML 文件 ， 呈 现 给 用 户 友好 的 显示 结果 ， 效 果 如 图 5.12 所 示 。 


pbbfe en, 


Exphoneowner Ex phone owner 


1348896 [sear | 1348896 | sara | 
使 用 GET 方 式 获取 信息 使 用 GET 方 式 获取 信息 
使 用 POST 方式 获取 信息 使 用 POST 方式 获取 信息 


POST 连接 手机 在 线 API 成 功 





图 5.11 POST 方式 获取 手机 号 码 信息 图 5.12 XML 解析 显示 
在 Android 中 解析 XML 文件 常用 的 有 3 种 方法 : DOM 、SAX 和 PULL，3 种 方法 各 
有 优 劣 。 在 这 里 我 们 使 用 Java 中 比较 熟悉 的 DOM 方法 来 解析 XML 文件 。 
1. 定义 电话 信息 类 
通过 分 析 返 回 的 XML 文件 ， 如 图 5.11 的 显示 ， 可 以 发 现 返 回 的 结果 主要 包括 了 查询 
的 手机 号 码 、 是 否 有 该 号 码 的 信息 、 归 属 的 省 份 、 归 属 的 城市 、 运 营 商 以 及 卡 的 类 型 等 信 


息 ， 我 们 可 以 定义 一 个 类 来 保存 这 些 信 息 。 并 且 定 义 修改 和 获取 这 些 信息 的 方法 。 信 息 类 
定义 如 下 : 
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01 public class Phone info { 


02 String query result; // 是 否 有 结果 

03 String number; // 号 码 

04 String province; // 省 份 

05 String city; // 城 市 

06 String corp; // 运 营 商 ， 如 移动 、 联 通 等 
07 String card; // 类 型 ， 如 GSM、CDMA 等 
08 

09 Public void set number (String result){ 

10 this. number =result; 

二 } 

12 public String get number (){ 

13 return number; 

14 } 

15 ee 其 他 信息 的 修改 、 获 取 方 法 …… 

3 


其 中 ，01 行 ， 定 义 信息 类 Phone info; 

02 一 07 行 ， 定 义 需 要 记录 的 信息 ; 

09 一 14 行 ， 分 别 定 义 了 修改 查询 号 码 和 获取 查询 号 码 的 方法 。 另 外 的 5 个 信息 同样 需 
要 定义 查询 和 获取 的 方法 ， 和 该 方法 类 似 。 

2. DOM 解 析 XML 


-个 XML 文件 , 一 般 都 包含 了 根 元 素 、 属 性 、 子 节点 等 ,解析 XML 文件 就 是 获取 我 

们 需要 的 节点 的 值 。 例 如 ， 获 得 的 XML 文件 中 ， 其 根 节点 是 QueryResponse， 子 节点 有 
Mobile、QueryResult 等 ， 每 个 子 节点 都 有 自己 的 内 容 。 我 们 解析 该 XML 文件 的 目的 就 是 
获取 子 节点 的 内 容 ， 保 存 到 电话 信息 类 中 。 使 用 DOM 解析 XML 文件 需要 如 下 几 步 来 

(1) 获得 DOM 解析 器 

要 获得 DOM 解析 器 ， 首 先 需 要 得 到 解析 器 的 工厂 实例 ， 使 用 方法 : 

DocumentBuilderFactory newInstance () 

其 中 ， 返回 为 一 个 工厂 类 DocumentBuilderFactory。 然 后 从 该 实例 中 ， 获 取 DOM 解析 
器 ， 使 用 方法 : 

DocumentBuilder newDocumentBuilder() 

其 中 ， 返 回 即 为 DOM 解析 器 。 

(2) 获得 Document 类 

使 用 DOM 解析 器 将 输入 的 XML 文件 输入 流 进行 解析 得 到 一 个 DOM 文件 树 , 以 便于 
内 容 的 获取 ， 使 用 方法 : 


Document parse (InputStream is) 





(3) 获得 XML 根 节点 
XML 文件 是 一 个 类 似 于 树 型 结构 的 文件 ， 需 要 获得 XML 文件 中 某 个 节点 的 属性 、 内 
容 ， 和 树 一 样 需要 从 根 节点 遍历 整个 树 。 获 得 根 节点 使 用 Document 类 的 方法 : 


Element getDocumentElement () 
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其 中 ， 返 回 为 Element 类 。 

(4) 获得 子 节点 

从 根 节点 起 ， 获 得 子 节点 ， 然 后 子 节点 继续 获取 其 子 节点 ， 从 而 不 断 地 轮 询 子 节点 达 
到 遍历 整个 树 的 目的 。 获 得 子 节点 的 方法 如 下 : 

NodeList getChildNodes () 

(5) 获得 节点 属性 

在 节点 中 ， 我 们 通过 属性 名 来 获取 该 属性 的 值 ， 使 用 方法 : 

String getAttribute (String name) 

其 中 ， 参 数 name 为 属性 名 。 

熟悉 了 使 用 DOM 解析 XML 文件 的 整个 流程 与 关键 点 , 下 面 来 看 看 使 用 DOM 来 解析 
获得 手机 号 码 基 本 信息 的 具体 实现 代码 : 


01 public static List<Phone info> read XML (InPutStream in _ Stream) { 





02 List<Phone info> phone infos = new RrrayList<Phone info>() 7 
// 电 话 信息 类 数组 

03 DocumentBuilderFactory factory =DocumentBuilderFactory. 

newInstance (); // 工 厂 实例 

04 | 

05 DocumentBuilder builder = factory.newDocumentBuilder(); 
// 获 取 解 析 器 

06 Document dom=builder.parse (in_Stream) ; // 输 入 流 解析 为 DOM 树 

07 Element root = dom.getDocumentElement () ;// 获 取 DOM 树 根 节点 

08 

09 NodeList items=root.getElementsByTagName 


("QueryResponse"); 


// 获 取 所 有 QueryResponse 的 标签 节点 ， 每 一 个 完整 的 标签 都 是 一 个 完整 的 手机 信息 


10 for (int i = 0; i < items.getLength(); i++) { 
// 遍 历 每 一 个 完整 的 手机 信息 

下 Phone info phone info = new Phone info(); 

2 // 获 得 第 一 个 QueryResponse 节点 

3 Element query node =(Element) items .item(i) 7 

14 // 获 得 QueryResponse 节点 下 的 所 有 子 节点 

5 NodeList childnodes=query node.getChildNodes (); 

16 for (int j = 0; j < childnodes.getLength(); j++) { 

了 Node node=childnodes .item(]j) 

18 if (node.getNodeType() == Node.ELEMENT NODE) { 

19 Element child node=(Element)node; 

20 // 获 取 各 项 值 

21 if ("QueryResult" .equals (child node.getNodeName ())) { 

22 Phone info.set query result(child node. 
getFirstChild() .getNodeValue() ); 

人 23 }else if ("Mobile".equals (child node. 
getNodeName () ) ) {// 电 话 号 码 

24 phone info.set number (child node. 

getFirstChild() .getNodeValue ()); 

25 jelse if ("Province".equals (child node. 
getNodeName () )) {// 省 份 

26 phone info.set province(child node. 

getFirstChild() .getNodeValue ()); 

Pi Jelse TE City -equalas(chiid nodes 
getNodeName () )) {// 城 市 

28 phone info.set city(child node. 
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getFirstChild() -getNodeValue ()); 


29 jelse if ("Corp" -equals (child node. 
getNodeName () ) ) {// 运 营 商 

30 phone info.set corp(child node. 
getFirstChild() .getNodeValue ()); 

< }else if ("Card".equals (child node. 

getNodeName () ) ) {// 类 型 

32 phone info.set card(child node. 
getFirstChild() .getNodeValue ()); 

33 4 

34 } 

35 } 

36 phone infos.add (phone info); ”// 添 加 到 数组 中 

37 » 

38 in Stream.close(); // 关 闭 数据 流 

40 } catch (Exception e) { 

41 e.printstackTrace (); 

42 下 

43 

44 return phone infos; // 返 回 查询 结果 数组 

45 } 


其 中 ，03 行 ， 得 到 解析 器 的 工厂 实例 factory; 

05 行 ，DOM 解析 器 builder; 

06 行 ， 使 用 解析 器 从 XML 文件 中 解析 得 到 其 对 应 的 Document 类 ; 

07 行 ， 获 得 根 节点 ; 

09 一 13 行 , 获得 根 节点 下 所 有 标签 名 为 QueryResponse 的 子 节点 。 由 于 在 查询 结果 中 ， 
每 一 个 号 码 的 查询 结果 在 一 个 节点 QueryResponse 中 ， 为 了 保证 查询 多 个 号 码 的 正确 性 ， 
需要 获取 所 有 的 节点 。 每 一 个 节点 中 包含 了 所 有 的 查询 结果 ， 对 应 于 一 个 手机 信息 类 
Phone_info 来 保存 信息 ; 

14 一 16 行 ， 获 得 QueryResponse 的 所 有 子 节点 ， 这 些 子 节点 即 是 号 码 的 属性 信息 ; 

17 一 36 行 ， 根 据 子 节点 标签 名 获取 需要 的 信息 ， 保 存 到 信息 列表 中 。 从 标签 
QueryResult、Mobile、Province、City、Corp、Card 中 获得 是 否 有 结果 、 查 询 号 码 、 归 属 省 
份 、 归 属 城市 、 运 营 商 以 及 卡 类 型 的 信息 ; 

44 行 ， 处 理 完成 后 ， 返 回 所 获得 的 号 码 信息 列表 。 


3. 显示 


获得 了 号 码 信息 列表 后 ， 将 这 些 信息 显 示 在 界面 中 ， 方 法 简单 就 不 再 讲解 。 最 终 实现 
的 效果 如 图 5.12 所 示 。 


5.4.4 总结 


在 这 一 节 中 ， 我 们 使 用 HttpURLConnection 方式 来 访问 网 络 ， 实 现 对 手机 号 码 归属 地 
的 查询 , 分 别 使 用 了 GET 和 了 POST 两 类 HTTP 请 求 方式 。 由 于 这 两 种 方式 在 请 求 时 的 参数 
差异 ， 所 以 在 实现 中 也 有 一 定 的 差别 。GET 方式 ， 参 数 在 URL 地 址 中 ， 从 而 URL 地 址 较 
复杂 ， 需 要 对 查询 内 容 进 行 拼凑 ;而 POST 方式 ， 参 数 在 http 请 求 正 文中 ， 所 以 需要 设置 
更 多 与 连接 相关 的 输入 输出 、 发 送 内 容 等 信息 。 另 外 ， 我 们 还 实现 了 使 用 DOM 方式 解析 
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XML 文件 。 由 于 XML 文件 格式 是 非常 常见 的 文件 格式 ， 所 以 解析 内 容 非常 重要 ， 在 后 面 
的 章节 中 ， 我 们 还 会 进一步 讲解 关于 XML 文件 解析 的 方法 。 

















5.5 天 气 预 报 


相信 大 家 在 使 用 Android 手机 的 时 候 ， 肯 定 都 是 用 过 天 气 预报 的 功能 ， 天 气 预 报 方面 
的 应 用 也 是 在 Android Market 上 下 载 量 最 大 的 。 在 这 一 节 中 ， 我 们 将 通过 HttpClient 访问 
Google 的 天 气 服务 的 方式 来 查询 天 气 信息 。 

由 于 信息 都 是 从 Google 的 天 气 服务 中 获取 的 ， 所 以 需要 使 用 到 网 络 ， 必 须 在 
AndroidManifest.xml 文件 中 申请 权限 ， 如 下 : 


<uses-permission android:name="android.permission.INTERNET"> 
</uses-permission> 


在 界面 方面 ， 比 较 简单 ， 只 需要 输入 查询 的 城市 ， 单 击 查 询 按钮 显示 结果 即 可 ， 如 图 


5.13 所 示 。 Cg 
5.5.1 天 气 获 取 Ex weather 


在 上 一 节 中 , 我 们 使 用 标准 的 Java 接口 来 实现 网 络 获取 
数据 ， 在 Android 中 也 提供 了 Apache 的 HttpClient， 它 对 标 
准 Java 中 的 网 络 接口 进行 了 封装 和 抽象 ,更 加 适合 在 Android 
上 进行 网 络 通信 。 接 下 来 ， 我 们 就 使 用 HttpClient 来 获取 天 
气 信息 。 

1. 创建 HttpClient 





使 用 DefaultHttpClient 类 来 表示 一 个 默认 的 HTTP 客户 
端 ， 可 以 把 它 想象 为 一 个 浏览 器 ， 我 们 使 用 其 API 来 方便 地 图 5.13 天 气 预报 
发 送 GET、POST 请 求 ， 以 及 接收 数据 等 。 在 进行 网 络 通信 
前 ， 首 先 创建 一 个 HttpClient。 常 用 的 构造 方法 如 下 : 

DefaultHttpClient () 


2. 创建 GET 请 求 
在 发 送 请 求 时 , 同样 有 GET 和 POST 两 种 方式 , 对 于 这 两 种 请 求 的 构建 分 别 使 用 方法 : 


HttpGet (String uri) 
HttpPost (String uri) 


这 两 种 请 求 的 地 址 差别 和 使 用 标准 Java 是 一 样 。 我 们 获取 天 气 预报 的 地 址 为 http: 
//www.google.com/ig/api?hl=zh-cn&weather=beijing。 地 址 最 后 是 城市 名 的 拼音 ， 所 以 在 界 
面 中 ， 要 求 输入 的 是 城市 名 的 拼音 。 实 现 如 下 : 


new HttpGet ("http://www.google.com/ig/api?hl=zh-cngweather=beijing") 
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3， 


获取 返回 


HttpResponse 是 HTTP 的 连接 响应 ， 当 执行 一 个 HTTP 连接 后 ， 就 会 返回 一 个 
HttpResponse， 我 们 通过 HttpResponse 来 获得 返回 的 数据 。 因 此 ， 获 取 HttpResponse 必须 
完成 一 个 HITP 连接 ， 使 用 HttpClient 类 的 方法 : 


execute (HttpUriRequest request) 
execute (HttpUriRequest request, HttpContext context) 


其 中 ,request 为 GET 或 POST 请 求 ,context 为 请 求 的 上 下 文 环境 。 然 后 从 HttpResponse 
中 获取 响应 状态 或 者 返回 数据 ， 常 用 的 方法 : 

HttpEntity getEntity() 
setEntity (HttpEntity entity) 
StatusLine getStatusLine() 
setstatusLine (StatusLine statusline) 

其 中 ， 前 两 种 方法 用 于 获取 和 设置 响应 的 实际 数据 内 容 ， 后 两 种 方法 用 于 获取 和 设置 
响应 的 状态 。 熟 悉 了 整个 流程 和 关键 点 ， 我 们 使 用 HttpClient 的 GET 请 求 方式 来 获取 天 气 
信息 ， 有 具体 实现 如 下 : 


// 使 用 HttpCient 连接 GoogleWeatherAPI 
private void httpClientConn (String city) { 


void 


void 


12 


3 


14 
15 
16 
h 
18 
20 
il. 
Ee 
23 


} 





DefaultHttpClient httpclient = new DefaultHttpClient(); 


// 获 取 Httpclient 类 
HttpGet httpget = new HttpGet (googleWeatherUr]l + city); 
//cjGET 请 求 
HttpContext localContext = new BasicHttpContext();// 
try { 
HttpResponse response = httpclient.execute (httpget, 
localContext); // 连 接 响应 
if (response.getStatusLine() .getStatusCode () != Httpstatus. 
sc Or) { 
httpget .abort (); // 连 接 失败 ， 中 断 连 接 
} else { 
HttpEntity httpEntity = response.getEntity(); 
// 获 取 返 回 数据 


String string = EntityUtils.toString (httpEntity, 
“nF=0n Er 

InputStream is = new ByteArrayInputstream(string. 
getBytes ("utf-8")); 

// 解 析 xml 


} catch (Exception e) { 

tv_result .setText (" 获 取 失 败 ") 
rinally { 

httpclient .getConnectionManager () .shutdown(); 
} 


其 中 ，03 行 ， 构 建 了 一 个 默认 的 HttpClient， 用 于 发 送 、 接 收 网 络 数据 ; 
04 行 ， 根 据 输 入 的 城市 名 称 构建 了 一 个 查询 的 HttpGet; 
05 一 07 行 ， 获 取 HttpClient 发 送 GET 请 求 后 返回 的 啊 应 HttpResponse; 
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08 一 09 行 ， 从 响应 response 中 获取 连接 状态 ， 当 连接 失败 时 ， 中 断 连 接 ; 

10 一 17 行 ， 从 响应 response 中 获取 响应 数据 ， 并 解析 获得 的 数据 。 

这 样 ， 我 们 就 获得 了 天 气 信息 ， 但 是 这 样 的 返回 内 容 不 方便 用 户 查看 。 我 们 直接 使 用 
正 浏览 器 访问 网 页 ， 查 看 返回 的 数据 ， 如 图 5.14 所 示 。 


(http: /wre. soogle conyigyapi?hl=zh-cnavea .. 





<?xml version="1.0" ?> 
Lapi_reply version="1"> 
- <weather module_id="0" tab_id="Q" mobile_row="Q" mobile_zipped="1" row="0" section="0"> 


BB <forecast_information> 
<condition data=" 多 云 " /> 
<temp_f data="64" /> 
<temp_c data="18" /> 
<humidity data=" 湿 度 : 779%" /> 
<icon data="/ig/images/weather/cn_cloudy.gif’ /> 
<wind_condition data=" 风 向 : ” 西 、 风 加 3 米 / 秒 " /> 


</current_conditions> 
<day_of_week data=" 周 五 * /> 
<low data="16" /> 
<high data="23" /> 
<icon data="/ig/images/weather/sunny.gif’ /> 
<condition ae /> 
</forecast ditions> 
< qa 三 =" 周 入" /> 
2 =16" /> 
<high data="21" /> 
<icon data="/ig/images/weather/mostly_sunny.gif’ /> 
<condition data=" 以 畏 为 主 " /> 
</forecast_conditions> 
- <forecast_conditions> 
<day_of_week data=" 周 日 " /> 





图 5.14 网 页 结果 


从 结果 中 ， 我 们 可 以 很 容易 地 看 出 这 是 一 个 XML 文件 格式 的 返回 结果 。 其 中 ， 
current_conditions 节点 是 当前 的 天 气 情况 ， 后 面 的 forecast_conditions 节点 是 未 来 几 天 的 天 
气 情况 。 这 些 未 来 几 天 的 天 气 情 况 就 是 我 们 需要 显示 的 内 容 。 可 以 看 出 每 一 个 天 气 je 
包括 了 时 间 、 最 低 和 最 高 温度 、 图 片 以 及 描述 。 接 下 来 就 来 解析 此 XML 文件 以 及 显 





5.5.2 XML 文件 解析 


在 上 一 节 中 ， 我 们 就 提 到 XML 的 文件 解析 方法 主要 有 DOM 、SAX 和 PULL3 种 ， 
并 且 详细 讲解 了 DOM 方法 。 但是，DOM 方法 解析 XML 文件 时 ， 会 将 XML 文件 的 所 有 
内 容 读 取 到 内 存 中 ， 所 以 内 存 的 消耗 比较 大 ， 而 对 于 运行 Android 的 移动 设备 来 说 ， 资 源 
比较 宝贵 ， 所 以 一 般 采 用 另外 两 种 方式 : SAX 和 PULL， 其 中 尤 以 SAX 使 用 最 多 。 在 这 一 
小 节 中 ， 我 们 分 别 使 用 SAX 和 PULL 来 解析 XML 文件 。 


1. 定义 信息 类 





一 个 XML 文件 一 般 都 是 具有 树 型 结构 的 ， 我 们 从 中 获取 的 信息 可 以 用 一 个 类 来 抽象 
保存 。 天 气 预 报 的 结果 ， 包 括 了 时 间 、 最 低 和 最 高 温度 、 图 片 以 及 描述 等 5 项 内 容 ， 所 以 
Weather 类 构造 如 下 : 
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01 public class Weather { 


02 Private String day; // 时 间 

03 Private String lowTemp; // 最 低温 度 
04 private String highTemp; // 最 高 温度 
05 Private String imageUr]l; // 图 片 地 址 
06 Private String condition; // 描 述 

07 

08 Public String getDay() { 

09 return day; 

10 } 

4 Public void setDay (String day) { 

2 this.day = day; 

13 

14 其 他 信息 的 修改 、 获 取 方 法 …… 

Lok 

其 中 ，02 一 06 行 ， 定 义 需要 保存 的 数据 ; 


08 一 13 行 ， 定 义 获 取 和 保存 时 间 的 方法 。 对 于 其 余 4 项 内 容 ， 同 样 需要 定义 获取 和 保 
存 的 方法 。 


2. SAX 解 析 


SAX (Simple API for XML) 是 一 种 解析 速度 快 并 且 占 用 内 存 少 的 XML 解析 器 ， 非 常 
适用 于 Android 的 移动 设备 。SAX 解析 XML 文件 采用 的 是 事件 驱动 ， 也 就 是 说 ， 它 并 不 
需要 解析 完整 的 文档 ， 在 按 内 容 顺 序 解析 文档 的 过 程 中 ，SAX 会 判断 当前 读 到 的 字符 是 否 
符合 XML 语法 中 的 某 部 分 ， 如 果 符 合 就 会 触发 事件 。 所 谓 事件 ， 其 实 就 是 一 些 回调 方法 ， 
这 些 事件 定义 在 DefaultHandler 中 。 接 下 来 就 来 详细 讲解 如 何 使 用 SAX 来 解析 XML 文件 。 

(1) 创建 SAX 解析 器 

首先 获得 SAX 工厂 然后 从 工厂 中 获得 解析 器 ， 实 现 如 下 : 

SAXParserFactory spf = SAXParserFactory.newInstance(); 

SAXParser saxParser = spf.newSAXParser (); // 创 建 解析 器 

(2) 实现 解析 DefaultHandler 

在 具体 的 XML 解析 中 ， 当 遇 到 不 同 的 事件 时 ， 将 回调 不 同 的 方法 来 处 理 ， 继 承 至 
DefaultHandler， 主 要 实现 其 中 4 个 方法 : 

void startDocument () 

当 遇 到 文档 开头 时 ， 调 用 该 方法 。 一 般 用 于 完成 一 些 预 处 理 。 

void endDocument () 

当 遇 到 文档 结束 时 ， 调 用 该 方法 。 一 般 用 于 实现 一 些 善 后 处 理 。 


void startElement (String uri, String localName, String gqName, Attributes 





attributes) 

当 读 到 一 个 开始 标签 的 时 候 ， 会 触发 这 个 方法 。 其 中 ，uri 就 是 命名 空间 ，localName 
是 不 带 命 名 空间 前 级 的 标签 名 ，qName 是 带 命名 空间 前 绥 的 标签 名 ，attributes 是 该 标签 节 
点 的 属性 和 相应 的 值 。 

需要 注意 的 是 ，SAX 一 个 重要 的 特点 就 是 它 的 流 式 处 理 ， 当 遇 到 一 个 标签 的 时 候 ， 它 
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并 不 会 记录 下 以 前 所 碰 到 的 标签 。 也 就 是 说 ， 在 startElement0 方 法 中 ， 所 有 能 获取 的 信息 
都 是 标签 的 名 字 和 属性 ， 至 于 标签 的 嵌 套 结构 、 上 层 标 签 的 名 字 、 是 否 有 子 元 属 等 其 他 与 
结构 相关 的 信息 ， 都 是 不 得 而 知 的， 都 需要 你 的 程序 来 完成 。 这 也 是 SAX 与 DOM 方式 最 
大 的 一 个 区 别 。 

void endElement (String uri, String localName, String qName) 

当 遇 到 结束 标签 的 时 候 ， 调 用 该 方法 。 一 般 完成 节点 结束 的 善后 处 理 。 

本 实例 中 ， 需 要 做 的 处 理 就 是 在 startElementO 中 保存 需要 的 数据 ， 例 如 获取 时 间 ， 实 
现 如 下 : 


String tagName = localName.length() != 0 ? localName : qName; 
ifE(tagName .equals ("day of week")) { 
currentWeather.setDay (attributes.getValue ("data")); 


(3) 实现 解析 

实现 了 具体 的 解析 处 理 过 程 ， 下 面 使 用 解析 器 SAXParser 的 处 理 方法 来 进行 处 理 : 

void parse (InputStream is, DefaultHandler dh) 

其 中 ， 参 数 is 是 XML 的 输入 流 ，dh 是 具体 处 理 的 Handler。 熟 悉 了 使 用 SAX 来 处 理 
XML 文件 的 整个 流程 和 关键 点 ， 来 看 看 实现 整个 流程 的 代码 如 下 : 

01 // 使 用 SAX 方式 解析 xml 








02 private static List<Weather> sax parseWeather (InputStream is) { 
03 Ey 

04 SAXParserFactory spf = SAXParserFactory.newInstance(); 
05 SAXParser saxParser = spf.newSAXParser() ;// 创 建 解析 器 

06 SAX Handler handler = new SAX Handler() ; // 初 始 化 结果 保存 类 
07 saxParser.parse(lis, handler); // 调 用 解析 方法 

08 is.close(); // 关 闭 数据 流 

09 return handler.getWeatherList (); 

10 } catch (Exception e) { 

汪汪 e.printstackTrace () 7 

12 } 

13 return null; 

14 } 


其 中 ，04 行 ， 获 得 SAX 处 理工 厂 ; 

05 行 ， 创 建 一 个 SAX 的 XML 解析 器 ; 

06 行 ， 初 始 化 SAX 的 处 理 类 ; 

07 行 , 实现 使 用 处 理 类 Handler 来 解析 XML 文件 输入 流 ， 处 理 的 结果 保存 在 Handler 中 ; 

08 一 09 行 ， 关 闭 数据 流 ， 并 返回 获得 的 解析 结果 即 Weather 数组 。 

接 下 来 实现 最 关键 的 解析 类 DefaultHandler。 在 Handler 中 需要 解析 、 获 取 、 保 存 Weather 
类 的 数组 ， 并 且 返 回 最 终 的 Weather 数组 ， 实 现 如 下 : 


01 public class SAX Handler extends DefaultHandler { 





02 private List<Weather> weatherList; //Weather 数组 

03 private boolean inForcast;// 标 记 是 否 是 forecast_conditions 内 的 标签 节点 
04 private Weather currentWeather; // 保 存 每 一 次 获取 的 Weather 
05 

06 Public List<Weather> getWeatherList() { 

07 return weatherList; 
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08 |; 

09 

10 Public SAX Handler() { 

i weatherList = new ArrayList<Weather> (); 
12 inForcast = false; 

3 . 


其 中 ，01 行 ， 定 义 继承 至 DefaultHandler 的 SAX 处 理 辅 助 SAX _Handler; 

02 一 04 行 ， 定 义 需要 保存 的 数据 ， 包 括 Weather 类 及 其 数组 、 标 记 ; 

05 一 08 行 ， 定 义 用 于 返回 最 终结 果 的 Weather 数组 的 方法 ; 

09 一 13 行 ， 定 义 SAX _Handler 的 构造 函数 ， 初 始 化 变量 。 

由 于 在 文档 开始 和 结束 时 ， 没 有 特别 需要 处 理 的 内 容 ， 所 以 只 需要 处 理 标 签 的 开始 和 
结束 。 在 标签 开始 时 ， 需 要 根据 标签 名 来 获取 保存 的 对 应 属性 值 。 有 具体 实现 如 下 : 

01 // 元 素 开始 时 触发 


02 @Override 
03 Public void startElement (String uri, String localName, String qName, 
04 Attributes attributes) throws SAXException { 
// 标 签 元 素 开始 时 触发 
05 String tagName = localName.length() != 0 ? localName : qName; 
06 tagName = tagName.toLowerCase(); 
07 
08 if(tagName.equals ("forecast conditions")) { // 当 标签 为 未 来 天 气 时 
09 inForcast = true; // 标 记 处 理 接 下 来 的 元 素 
1T0 currentWeather = new Weather(); // 实 例 化 天 气 类 
11 1) 
了 2 
1s if(inForcast) { // 开 始 处 理 
14 if(tagName.equals ("day of week")) {// 星 期 标签 
15 currentWeather .setDay (attributes.getValue ("data")); 
// 获 取 星 期 数据 
16 }else if (tagName.equals ("low")) {// 最 低温 度 标签 
hn currentWeather.setLowTemp (attributes.getValue ("data")); 
// 获 取 最 低温 度数 据 
18 jelse if(tagName.equals ("high")) {// 最 高 温度 标签 
19 
currentWeather.setHighTemp (attributes.getValue ("data") ) ; // 获 取 最 高 温度 数据 
20 }else if (tagName.equals ("icon")) {// 图 片 标签 
之 二 
currentWeather.setImageUrl (attributes.getValue ("data")); // 获 取 图 片 数据 
22 }else if(tagName .equals ("condition")) { // 描 述 标签 
23 
currentWeather .setCondition (attributes.getValue ("data") ) ; // 获 取 描 述 数据 
24 } 
25 
26 } 


其 中 ，01 一 04 行 ， 定 义 重 写 startElement() 方 法 ， 用 于 实现 具体 的 标签 开始 处 理 ; 

05 一 06 行 ， 获 取 标 签名 。 当 不 带 命 名 空间 的 标签 名 为 空 时 获得 带 命 名 空间 的 标签 名 ， 
否则 获得 不 带 命名 空间 的 标签 名 ; 

07 一 11 行 ， 判 断 标 签名 是 否 为 forecast_ conditions。 是 该 标签 时 ， 设 置 标识 并 且 创 建 一 
个 Weather 类 ， 用 于 对 接 下 来 的 具体 属性 信息 进行 保存 ; 

12 一 25 行 ， 保 存 天 气 的 属性 信息 。 当 已 经 在 forecast_conditio 标签 内 后 ， 根 据 其 内 的 
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二 级 标签 名 day_of week、low、high、icon 和 condition 来 获得 Weather 内 的 时 间 、 最 低温 
度 、 最 高 温度 、 图 片 地 址 和 描述 信息 。 

在 标签 结束 时 ， 只 需要 对 forecast conditions 标签 ， 进 行 标 识 的 设置 和 Weather 数组 的 
添加 ， 有 具体 实现 如 下 : 


01 ”// 元 素 结束 时 


02 @Override 

03 Public void endElement (String uri, String localName, String qName) 
04 throws SAXException { 

05 String tagName = localName.length() != 0 ? localName : qName; 
06 tagName = tagName.toLowerCase(); 

07 if(tagName.equals ("forecast conditions")) { // 天 气 标签 结束 

08 inForcast = false; // 完 成 单个 天 气 类 

09 weatherList.add (currentWeather); // 添 加 到 天 气 数组 

10 1 

ll } 


其 中 ，01 一 04 行 ， 定 义 重 写 endElement () 方 法 ， 用 于 实现 具体 的 标签 结束 处 理 ; 
05 一 11 行 ， 获 得 标签 名 ， 当 标签 为 forecast_conditions 时 ， 设 置 标识 并 添加 数组 。 


3. PULL 解 析 


在 Android 中 ， 内 置 了 PULL 解析 器 来 解析 XML 文件 ， 上 一 章 中 SharedPreferences 
的 解析 就 是 使 用 PULL 解析 器 来 进行 的 解析 ,PULL 解析 器 的 运行 方式 与 SAX 解析 器 相似 ， 
它 提供 了 类 似 的 事件 ， 例 如， 开始 元 素 和 结束 元 素 事 件 ， 使 用 parser.next0 可 以 进入 下 一 个 
元 素 并 触发 相应 事件 。 每 一 种 事件 将 作为 数值 代码 被 发 送 ， 因 此 使 用 一 个 switch 来 对 感 兴 
趣 的 事件 进行 处 理 。 当 元 素 开始 解析 时 ， 调 用 parser.nextText() 方 法 可 以 获取 下 一 个 Text 
类 型 元 素 的 值 。 具 体 实现 过 程 如 下 : 

(1) 创建 PULL 解析 器 

首先 获得 PULL 工厂 ， 然 后 从 工厂 中 获得 解析 器 ， 实 现 如 下 : 


XmlPullParserFactory xpparseFactory = XmlPullParserFactory.newInstance (); 
XmlPullParser xpparser = xpparseFactory.newPullParser(); 


在 解析 器 中 ， 提 供 了 多 种 方法 来 获得 XML 数据 的 不 同 标签 、 属 性 等 信息 。 常 用 的 方 
法 有 : 

void setInput (InputStream inputStream, String inputEncoding) 

该 方法 用 来 设置 需 解析 的 XML 数据 流 及 其 编码 。 


int getEventTYpe () 











该 方法 用 来 获得 事件 类 型 , 例如 START _ DOCUMENT( 文 档 开 始 )\END DOCUMENT 
(文档 结束 ) 、START_TAG (标签 开始 ) 、END_TAG (标签 结束 ) 等 。 


String getName () 


该 方法 用 于 获得 标签 名 。 


String getAttributeName (int index) 
String getAttributeValue (String namespace, String name) 
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这 两 种 方法 用 














来 获得 标签 节点 的 属性 ， 第 一 种 方法 是 根据 节点 属性 的 序号 来 获取 ， 参 


数 为 序号 ; 第 二 种 方法 是 根据 节点 的 属性 名 来 获取 ， 参 数 namespace 是 命名 空间 ,name 是 


属性 名 。 


int next () 


该 方法 获得 解析 的 下 一 个 事件 ， 返 回 值 为 事件 的 类 型 编号 。 


(2) 解析 处 理 





我 们 由 解析 器 获得 事件 类 型 ， 对 不 同 的 事件 分 别 进行 处 理 ， 直 到 文档 结束 。 本 实例 具 


体 的 解析 如 下 : 
01 // 使 用 PULL 解析 XML 
02 private static List<Weather> pull parseWeather (InputStream is) { 
03 List<Weather> weatherList = new ArrayList<Weather>(); 
04 boolean inForcast = false; 
05 Weather currentWeather = null; 
06 Ey 
07 XmlPullParserFactory xpparseFactory = XmlPullParserFactory. 
newInstance(); 
08 // 解 析 器 
09 XmlPullParser xpparser = xpparseFactory.newPullParser(); 
10 // 获 取 XML 数据 
J xpparser.setInput (is, "utf-8"); 
12 // 开 始 解析 事件 
13 int event type = xpparser.getEventType(); 
14 // 处 理事 件 ， 直 到 文档 结束 
15 while (event type != XmlPullParser.END DOCUMENT) { 
16 switch (event type) { 
py case XmlPullParser .START TAG: 
18 // 标 签 开始 
19 String tag name = xpParser.getName() 
20 if (tag name.equals("forecast conditions")) { 
// 天 气 标签 
2 currentWeather = new Weather () ; // 天 气 类 
22 inForcast = true; // 是 否 处 理 的 标识 
23 } 
24 
id if (inForcast) { 
26 if (tag name.equals("day of week")) { 
27 currentWeather. setDay (xpparser. 
getAttributeValue (null, "data") ); 
2 8 -其 他 信息 的 获取 .………… 
EA break; 
30 case XmlPullParser.END TAG: // 标 签 结束 
31 String tag endname = xpparser.getName (); 
32 if (tag endname.equals ("forecast conditions")) { 
// 天 气 标签 结束 
33 inForcast = false; 
34 weatherList .add (currentWeather) 
35 } 
3 break; 
3 default: 
38 break; 
39 } 
40 event type = xpparser.next(); // 下 一 个 节点 事件 
41 } 
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42 is.close(); 

43 } catch (Exception e) { 
44 e.printstackTrace (); 
45 ); 

46 return weatherList; 

47 } 


其 中 ，01 一 05 行 ， 定 义 并 初始 化 需要 使 用 的 变量 ; 

07 行 ， 创 建 PULL 处 理 的 工厂 类 ; 

09 行 ， 创 建 PULL 处 理 的 解析 器 ; 

11 行 ， 设 置 PULL 解析 器 需要 处 理 的 XML 文件 输入 流 及 其 编码 方式 ; 

13 一 15 行 ， 获 得 解析 器 的 解析 事件 ， 直 到 事件 为 文档 结束 END_DOCUMENT 时 ， 停 
止 解析 处 理 ; 

17 一 29 行 ， 当 事件 为 标签 开始 START_TAG 时 , 进行 处 理 ， 根 据 标签 名 来 获取 保存 的 
对 应 属性 值 。 和 SAX 中 的 startElement() 方 法 类 似 ; 

30 一 36 行 ， 当 事件 为 标签 结束 END_TAG 时 ， 进 行 处 理 ， 和 SAX 中 的 endElement() 
方法 类 似 ; 

40 行 ， 对 一 个 事件 处 理 完 成 后 ， 解 析 下 一 个 事件 。 

4. 总 结 








以 上 分 别 使 用 SAX 和 PULL 两 种 方式 实现 了 对 同一 个 XML 文件 流 的 解析 处 理 , 再 加 
上 上 一 节 中 的 DOM 方式 , 我们 实现 了 对 XML 文件 解析 的 DOM、SAX 和 PULL3 种 方法 。 
这 3 种 方法 ， 各 有 优 缺 ， 如 下 所 示 。 
口 DOM 方式 由 于 将 XML 所 有 内 容 读 取 到 内 存 中 ， 所 以 内 存 的 消耗 比较 大 ， 并 不 适 
合 单纯 自 上 而 下 的 XML 解析 获取 数据 ,但 是 它 保存 了 XML 本 身 的 树 型 数据 结构 ， 
可 以 很 容易 地 获得 某 个 节点 的 父 、 子 节点 等 结构 信息 。 

口 SAX 是 事件 驱动 ， 并 不 需要 解析 完整 个 文档 ， 按 内 容 顺 序 逐 步 解 析 文 档 ， 解 析 速 
度 快 并 且 占 用 内 存 少 ， 非 常 适合 在 Android 中 解析 XML 文件 获取 需要 的 信息 。 

口 PULL 方式 的 工作 机 制 和 SAX 类 似 ， 并 且 可 以 在 while 循环 中 提前 结束 解析 ， 当 

访问 XML 文件 中 的 一 小 部 分 时 ， 可 以 尽快 地 停止 解析 ， 减 少 解析 时 间 。 

这 3 种 方式 在 解析 的 过 程 中 ,都 首先 需要 从 各 自 的 工厂 类 中 获得 对 应 的 解析 器 。DOM 
方式 ， 从 根 节点 开始 ， 通 过 不 断 向 下 遍历 其 子 节点 而 遍历 整 棵 树 ， 找 到 感 兴趣 的 节点 进行 
对 应 的 处 理 ，SAX 方式 ， 使 用 解析 类 DefaultHandler 定义 的 方法 来 处 理 对 应 的 事件 ， 特 别 
是 startDocument()、endDocument()、startElement( 〇 和 endElement() 方 法 ; PULL 方式 ， 使 用 
while 循环 来 不 断 获 取 下 一 个 事件 ， 根 据 事件 类 型 进行 对 应 的 处 理 。 





5.5.3 ”结果 显示 


从 Google 获得 的 XML 格式 的 数据 ， 通 过 SAX 或 PULL 方式 解析 之 后 ， 我 们 获得 了 
Weather 类 的 数组 ， 在 界面 显示 就 比较 简单 了 。 但 是 Weather 中 保存 的 图 片 只 是 一 个 不 完 
整 的 URL 地址， 需要 下 载 该 图 片 。 接 下 来 ， 我 们 使 用 HttpClient 下 载 图 片 。 

使 用 HttpClient 来 下 载 图 片 和 获取 普通 数据 的 流程 是 相同 的 ， 只 是 要 对 获得 的 输入 流 


也 
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转 为 Bitmap 位 图 。 使 用 位 图 工厂 BitmapFactory 类 的 方法 : 


Bitmap decodqeStream(InputStream is) 


其 中 ， 参 数 is 为 输入 流 ， 返 回 为 Bitmap 图 。 具 体 的 下 载 实现 如 下 : 





01 // 下 载 天 气 图 片 
02 private Bitmap getnet_Bitmap (String url) { 
03 Bitmap bitmap = null; 
04 3 
05 //HttpGet 
06 HttpGet httpget = new HttpGet ("http://www.google.com/" + url) 
// 初 始 化 httpget 
07 //DefaultHttpClient 
08 DefaultHttpClient httpclient = new DefaultHttpClient(); 
09 HttpContext localContext = new BasicHttpContext (); 
10 HttpResponse response = httpclient.execute(httpget, 
localContext); // 连 接 获 取 数 据 
4 HttpEntity httpEntity = response.getEntity(); 
// 获 取 返 回 数据 
2 InputStream is=httpEntity.getContent(); // 获 取 返 回 数据 流 
13 bitmap = BitmapFactory.decodeStream(is); 
// 将 数据 流 编码 为 图 片 
14 is.close() ;// 关 闭 数据 流 
5 } catch (IOException e) { 
16 e.printSstackTrace (); 
和 } 
18 return bitmap;// 返 回 图 片 
19 } 


其 中 ，06 行 ， 构 建 HttpGet。 由 于 获得 的 地 址 不 是 完整 的 URL 地 址 ， 只 有 后 一 半 的 地 
前 面 缺 少 了 http://www.google.com/， 需 要 补 全 URL 地 址 ; 

08 一 12 行 ， 使 用 HttpClient 访问 图 片 地 址 ， 并 获得 返回 响应 的 输入 流 is; 

13 行 ， 使 用 方法 decodeStream0O 将 获得 的 输入 流 编码 为 Bitmap 类 的 图 。 

其 他 的 数据 都 是 直接 可 以 用 于 显示 的 String 类 型 ， 比 较 简 单 ， 相 信 大 家 通过 前 面 的 讲 
解 已 经 能 够 自己 实现 。 最 终 的 实现 的 效果 ， 如 本 节 开 始 的 图 5.13 所 示 。 
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5.5.4 总 结 


在 这 一 节 中 ， 我 们 通过 HttpClient 方式 来 访问 网 络 ， 实 现 对 未 来 几 天 天 气 的 查询 。 该 
方式 对 HTTP 进行 了 封装 和 抽象 ， 使 用 起 来 更 方便 ， 可 以 想象 为 浏览 器 与 远程 HITP 服务 
器 的 交互 过 程 。 本 节 重 点 讲解 了 在 Android 中 对 XML 文件 格式 解析 更 常用 的 SAX 和 PULL 
两 种 方法 ， 并 比较 了 DOM、SAX 和 PULL3 种 方式 各 自 的 优 缺 点 以 及 异同 。 


5.6 在 线 翻 译 


在 前 两 节 ， 我 们 分 别 使 用 HttpURLConnection 和 HttpClient 两 种 方式 ， 通 过 请 求 服务 
器 端 来 获取 需要 查询 的 手机 号 码 信息 和 未 来 天 气 信息 。 在 本 节 中 ， 我 们 将 讲解 另 一 种 调用 
服务 器 端的 方法 来 获取 数据 的 方式 一 一 Web Service， 并 使 用 Web Service 方式 来 实现 在 线 
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翻译 的 功能 。 
在 线 翻 译 的 界面 设计 非常 简单 ， 只 需要 一 个 输入 框 、 一 个 查询 按钮 以 及 查询 显示 的 结 
果 即 可 ， 如 图 5.15 所 示 。 
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图 5.15 “在线 翻译 


和 前 面 的 网 络 应 用 是 一 样 的 ， 必 须 在 AndroidManifestxml 文件 中 申请 权限 ， 如 下 : 


<uses-permission android:name="android.permission.INTERNET"></uses- 
permission> 


5.6.1 Web Service 环境 


Web Service 是 一 种 基于 简单 对 象 访问 协议 (Simple Object Access Protocol，SOAP) 的 
远程 调用 标准 。 它 通过 XML 格式 的 特殊 文件 来 描述 方法 、 参 数 、 调 用 和 返回 值 ， 该 XML 
文件 称 为 WSDL (Web Service Description Language) 。Web Service 可 以 将 不 同 操作 系统 
平台 、 不 同 语言 及 不 同 技术 整合 到 一 起 。 

在 Android SDK 中 并 没有 提供 调用 Web Service 的 库 ， 因 此 ， 需 要 使 用 第 三 方 的 SDK 
来 调用 Web Service。 在 PC 上 的 Web Service 客户 端 库 非 常 丰富 ， 如 Axis2、Xfire 等 ， 但 
这 些 开 发 包 对 于 Android 系统 来 说 过 于 庞大 。 适 合 手机 的 Web Service 客户 端的 SDK 比较 
常用 的 就 是 KSOAP。 相 信 做 过 Java ME 的 人 都 知道 有 KSOAP 这 个 第 三 方 的 类 库 ， 它 可 以 
帮助 我 们 获取 服务 器 端的 Web Service 调用 。 下 面 我 们 就 使 用 KSOAP 库 来 实现 Web Service 
客户 端 。 

KSOAP 可 以 从 http://code.google.com/p/ksoap2-android/downloads/list 进行 下 载 。 将 下 
载 的 KSOAP 包 ksoap2-android-assembly-2.5.8-jar-with-dependencies.jar 包 复 制 到 Android 工 
程 的 lib 目录 中 ， 同 时 在 Eclipse 工程 中 引用 这 个 jar 包 。 

在 需要 使 用 的 Android 项 目的 右键 菜单 中 选择 |build pathlconfigure build path 命令 ， 如 
图 5.16 所 示 。 
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图 5.16 配置 lib 


在 出 现 的 配置 界面 中 ， 选 择 Libraries 选项 卡 ， 单 击 Add JARs 按钮 ， 选 择 需 要 添加 的 
KSOAP 库 ， 如 图 5.17 所 示 。 








Choose the archives to be added to the build path: 





5.17 添加 KSOAP 库 
这 样 添加 了 KSOAP 库 之 后 ， 我 们 就 可 以 使 用 KSOAP 库 来 实现 Web Service 客户 端 。 


5.6.2 Web Service 服务 调用 


使 用 KSOAP 库 来 实现 客户 端 调用 远程 服务 器 的 方法 ， 可 以 按 如 下 几 步 来 实现 : 
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1. 实例 化 SoapObject 


实例 化 SoapObject， 使 用 如 下 方法 : 


SoapObject (String namespace, String name) 


其 中 ， 参 数 namespace 是 Web Service 的 命名 空间 ， 参 数 name 是 调用 的 方法 。 在 使 用 
Web Service 之 前 ， 必 须 找 到 提供 Web Service 服务 的 网 站 。 本 实例 的 在 线 翻 译 ， 使 用 的 服 
务 网 站 是 http://www.webxml.com.cn/zh_cn/web_services.aspx。 该 网 站 不 仅 提供 英汉 翻译 ， 
还 提供 了 天 气 预报 、 手 机 号 归属 地 、IP 地 址 归属 地 、 股 票 行情 等 Web 服务 。 

打开 上 面 的 网 站 ， 找 到 我 们 需要 的 中 英 双 向 翻译 Web 服务 ， 如 图 5.18 所 示 。 单 击 打 
开 WSDL 链接 http://fy.webxml.com.cn/webservices/EnglishChinese.asmx?wsdl。 在 前 面 ， 我 
们 已 经 知道 WSDL 中 描述 了 Web Service 服务 提供 的 方法 、 参 数 、 调 用 和 返回 值 。 所 以 ， 
我 们 可 以 从 WSDL 文件 中 获取 很 多 有 用 的 信息 , 从 某 种 意义 上 说 WSDL 等 同 于 API 文档 。 
当然 ， 一 般 的 Web Service 服务 同时 会 提供 说 明文 档 ， 可 以 结合 WSDL 一 起 阅读 ， 了 解 
WSDL 中 各 元 素 的 意思 。 











[新 ] 中 文 < > 英文 双向 翻译 WEB 服 务 半生 从 二 

Endpoint: http: /fy.webxml.com.cnWwebsen CH asmx 面 

Disco: http://ty webxml.com.cnNvebservices/EnglishChinese ssmx?disco 四 

Wy Wy .webxml.com.cniwebservices/EnglishChinese .asmx?wsf 焉 一 一 > 

R 新 中 文 <-> 英 六 戏 出 译 WEB 服 务 ， 永久 免费 。 提 供 间 译 、 音 标 ( 拼音 ) 、 解 和 

3 相关 记 杀 、 例 句 、 读 音 MP3 支 持 《 英文 On ) 、 伐 选 语 等 功 能 。 比 原来 的 中 共立 颈 
部 i 泽 WEB 服 务 提供 更 儿 更 强大 的 咏 能 。 玫 助 立 档 






图 5.18 ”中 英 翻译 服务 


打开 WSDL， 我 们 可 以 很 容易 找到 Web Service 的 命名 空间 targetNamespace=http: 
/WebXmlcom.cn/， 如 图 5.19 所 示 。 


| 国 http:7Gy webpmml com. cayvebservices/Enai 和 丛 - 国名 局 ”页面 安全 外， 工具 Q)- 砚 - 








<?xml version="1.0" encoding="utf-8" ?> 
- <wsdl:definitions xmiIns:soap="http://schemas.xmisoap.org/wsdi/soap/" 
a /" 


| 





href="http://www.webxml.com.cn/" target="_blank">WebXml.com.cn</a> <strong> 中 文 &lt;-&gt; 英 文 双 
向 翻译 WEB 服 务 ， 永 久 免 费 </strong>。 提 供 词典 翻译 、 音 标 〔 拼 音 ) 、 解 释 、 相 关 词 条 、 例 句 、 读 音 (英文 Only) 、 候 选 
词 等 功能 。</br> 传 递 中 文 参数 请 使 用 UTF- 8 编码 ， 使 用 本 站 WEB 服 务 请 注 明 或 链接 本 站 : 


ee- fense enh am cnt 的 支持 | 一 hr /Nhe /Zim 2 nn Fit nt en 


图 5.19 WSDL 文档 


在 WSDL 文档 中 ,不 太 容 易 看 出 提供 了 哪些 方法 ， 查 看 其 说 明文 档 ， 可 以 发 现 
Web Service 服务 器 端 提 供 的 方法 主要 有 : 

Translator 

通过 输入 中 文 或 英文 单词 进行 双向 翻译 ， 输 入 参数 wordKey- 字 符 串 、 中 文 或 英文 音 
词 ， 返 回 名 称 为 Dictionary 的 DataSet。 
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TranslatorString 
通过 和 输入 中 文 或 英文 单词 获得 基本 翻译 ， 输 入 参数 wordKey= 字 符 串 、 中 文 或 英文 单 
词 ， 返 回 为 一 维 数组 ，String[0] 一 String[4]。 
TranslatorReferString 
通过 输入 中 文 单词 获得 相关 词 条 ， 输 入 参数 wordKey= 字 符 串 、 中 文 单词 ， 返 回 为 一 
维 数组 ，String[0] 一 String[m] 。 
TranslatorSentenceString 
通过 输入 中 文 或 英文 单词 获得 中 译 英 的 例句 ,输入 参数 wordKey = 字符 串 、 中 文 单词 ， 
回 为 一 维 数组 ，String[0] 一 String[m] 。 
在 这 里 我 们 只 需要 对 输入 的 英文 单词 获取 基本 的 翻译 即 可 , 使 用 方法 TranslatorString， 
在 实例 化 SoapObject 时 ， 实 现 如 下 : 


private static final String SERVICE NS = "http://WebXml.com.cn/"; 
String methodName = "TranslatorString"7 
SoapObject soapObject = new SoapObject (SERVICE NS, methodName); 


2. 设置 调用 方法 的 参数 

















册 


实例 化 SoapObject 后 ， 已 经 明确 了 使 用 Web Service 服务 中 提供 的 方法 。 这 些 方法 一 
般 都 是 需要 参数 的 ， 接 下 来 便 是 设置 调用 方法 的 参数 。 使 用 SoapObject 类 的 方法 : 

addProperty (java.lang.String name, java.lang.Object value) 

其 中 ， 参 数 name 是 调用 方法 参数 的 名 称 ， 参 数 value 是 值 。 例 如 ， 我 们 使 用 方法 
TranslatorString, 从 Web Servcie 服务 器 端 提 供 的 说 明文 档 中 可 以 看 出 其 输入 参数 wordKey= 
字符 串 ， 在 设置 时 实现 如 下 : 


private static final String WORD KEY = "wordKey"; 
soapObject .addProperty (WORD KEY, "android"); 


3. 设置 SOAP 的 请 求 信息 


使 用 类 SoapSerializationEnvelope 来 将 请 求 信息 序列 化 ,并 发 送 到 服务 器 端 上 。 其 构造 
函数 如 下 : 


SoapSerializationEnvelope (int version) 


其 中 ， 参 数 version 是 SOAP 协议 的 版 本 号 ， 该 版 本 号 需要 与 Web Service 中 的 版 本 号 
一 致 。 我 们 可 以 从 WSDL 中 找 出 版 本 号 : xmlns:soap12="http://schemas.xmlsoap- 
org/wsdl/soap12/"。 在 图 5.19 中 命名 空间 的 上 一 行 。 

从 SoapEnvelope 类 中 ， 设 置 发 送 的 数据 和 接收 数据 ， 分 别 使 用 方法 : 

bodyOut 

bodyIn 

在 本 实例 中 ， 设 置 如 下 : 


SoapSerializationEnvelope envelope = new SoapSerializationEnvelope 
(SoapEnvelope.VER12); 
envelope.bodyOut = soapObject; 
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4. 创建 HttpTransportsSE 对 象 


通过 HttpTransportsSE 类 的 构造 方法 可 以 指定 Web Service 的 WSDL 文档 的 URL: 


HttpTransportSE (String url) 


本 实例 中 使 用 的 翻译 服务 ， 实 现 如 下 : 


private static final String SERVICE URL = "http://fy.webxml.com.cn/ 
webservices/EnglishChinese.asmx"; 

HttpTransportSsE ht = new HttpTransportSsE (SERVICE URL); 

ht.debug = true; 


5. 调用 Web Service 的 方法 

完成 以 上 设置 后 ， 就 可 以 使 用 远程 Web Service 服务 器 端 提供 的 方法 ， 使 用 
HttpTransportsSE 类 的 : 

void call (String soapAction, SoapEnvelope envelope) 

其 中 ， 参 数 soapAction 是 命名 空间 和 方法 名 称 结合 的 字符 串 ， 参 数 envelope 是 已 创建 
的 SoapEnvelope 对 象 。 在 本 实例 中 ， 调 用 方法 TranslatorString 实现 如 下 : 

ht.call (SERVICE NS + methodName, envelope); 

6. 获得 Web Service 方 法 的 返回 结果 

在 客户 端 发 送 请 求 、 服 务 器 完成 了 方法 的 处 理 之 后 ， 将 结果 返回 客户 端 。 在 客户 端 使 
用 SoapSerializationEnvelope 类 的 方法 来 获取 : 

getResponse () 

以 上 就 是 使 用 KSOAP 库 实现 Web Service 客户 端的 整个 流程 和 关键 点 ,下面 我 们 使 用 
Web Service 提供 的 中 英 双 向 翻译 的 服务 ， 来 实现 在 线 翻译 的 功能 ， 具 体 实现 如 下 : 

01 private static final String SERVICE URL = "http://fy.webxml.com.cn/ 


webservices/EnglishChinese.asmx"; 
02 private static final String SERVICE NS = "http://WebXml.com.cn/"; 


// 服 务 器 命名 空间 
03 private static final String WORD KEY = "wordKey"; // 服 务 器 方法 参数 
04 String methodName = "TranslatorString"7 /1 服务 器 调用 方法 


05 //webservice 获取 数据 
06 private List<String> getSoapObject (String words) throws Exception { 


07 SoapObject soapObject = new SoapObject (SERVICE NS, methodName); 
// 实 例 化 Soapobject 

08 soapObject.addProperty (WORD KEY, words); // 设 置 调 用 方法 

09 SoapSerializationEnvelope envelope = new SoapSerializationEnvelope 

(SoapEnvelope .VER12); 

10 envelope.bodyOut = soapObject; 

1 HttpTransportSE ht = new HttpTransportSE (SERVICE URL) ; // 创 建 对 象 

2 ht.debug = true; 

13 envelope.dotNet = true; 

14 ht.call (SERVICE NS + methodName，envelope) ;// 调 用 方法 

15 if (envelope.getResponse() != null) { // 判 断 返 回 数据 是 否 为 空 

16 SoapObject so = (SoapObject) envelope.bodyIn;// 获 取 返 回 数 据 

Ln // 获 取 的 数据 处 理 
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18 String name value = methodName + "Result"7 

19 SoapObject detail = (SoapObject) so.getProperty (name value); 
20 messageList = new ArrayList<String>(); 

忆 中 B for (int i = 0; i < detail.getPropertyCount(); i++) { 

攻 安 messageList.add (detail.getProperty(i) .tostring()); 

23 } 

24 return messageList; 

3 } 

26 return null; 

2 


其 中 ，01 一 04 行 ， 定 义 并 初始 化 Web Service 服务 器 端的 命名 空间 、 访 问 地 址 、 使 用 
的 方法 名 、 方 法 的 参数 名 ; 

07 行 ， 初 始 化 soapObject， 其 访问 的 服务 器 端 命名 空间 为 http://WebXml.com.cn/， 使 
用 的 方法 为 TranslatorString; 

08 行 ， 设 置 调用 方法 的 参数 ， 参 数 名 为 wordKey， 值 为 传 入 的 查询 单词 ; 

09 一 10 行 ， 设 置 SOAP 的 请 求 信息 ，SOAP 版 本 号 为 12; 

11 一 13 行 ， 创 建 HttpTransportsSE 对 象 ; 

14 行 ， 调 用 Web Service 服务 器 端的 方法 ; 

15 一 24 行 ， 对 返回 的 结果 进行 处 理 。 





5.6.3 总 结 


在 这 一 节 中 , 我 们 通过 使 用 Web Service 方式 实现 了 在 线 翻译 的 功能 。 在 Android 平台 
上 使 用 Web Service 的 主要 原因 是 Android 的 处 理 能 力 有 限 , 不 足以 完成 复杂 计算 , 所 以 将 
复杂 的 计算 部 署 在 远程 服务 器 上 ， 而 Android 只 能 充当 这 些 应 用 的 客户 端 。 

在 使 用 远程 Web Service 服务 时 ， 不 仅 需要 知道 使 用 远程 Web Service 的 流程 ,更 重要 
的 是 读 懂 远 程 Web Service 的 WSDL 以 及 说 明文 档 ， 从 中 获取 Web Service 服务 器 端的 命 
名 空间 、 访 问 地 址 、 提 供 使 用 的 方法 、 各 方法 的 参数 以 及 使 用 的 SOAP 版 本 号 信息 。 





5.7 简易 浏览 器 


在 Android 中 可 以 很 容易 地 实现 一 个 定制 的 浏览 器 , 因为 Android 提供 了 WebView 控 
件 专门 用 来 浏览 网 页 ， 使 用 非常 方便 。 在 这 一 节 中 ， 我 们 将 使 用 WebView 控件 来 实现 定 
制 浏览 器 , 使 浏览 器 具有 网 页 拍照 的 功能 。WebView 的 网 页 泻 染 引擎 使 用 的 是 Webkit， 它 
同样 也 是 Safari、Chrome 浏览 器 的 网 页 泻 染 引擎 。 

在 实现 具体 的 功能 之 前 ， 和 前 面 的 网 络 应 用 程序 一 样 的 ， 必 须 在 AndroidManifest xml 
文件 中 申请 权限 ， 如 下 : 


<uses-permission 
android:name="android.permission.INTERNET"></uses-permission> 








5.7.1 浏览 网 页 


在 Android 中 ,实现 浏览 网 页 使 用 WebView 控件 就 能 实现 。 在 界面 中 ， 需 要 一 个 输入 
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待 访问 网 页 地 址 的 输入 框 、 一 个 跳 转 按钮 以 及 显示 网 页 的 WebView 控件 ， 效 果 如 图 5.20 





所 示 。 
mp 
图 5.20 浏览 网 页 
1. XML 布局 


在 XML 布局 文件 中 ， 定 义 一 个 WebView 控件 ， 实 现 如 下 : 


<WebView android:layout width="fill Parent" 
android:layout_height="wrap_content"” android:id="@+id/webview" /> 


2. WebView 设 置 


对 于 WebView 的 一 些 属性 、 状 态 等 都 是 通过 WebSetting 来 进行 设置 的 ， 获 取 
WebSetting 的 方法 为 : 
WebSettings getSettings () 


在 设置 时 ， 常 用 的 属性 和 状态 设置 有 如 下 几 种 方法 : 


Void 
void 
void 
void 
void 
void 
void 
void 
void 


setAllowFileAccess (boolean allow) 
setBlockNetworkImage (boolean flag) 
setBuiltInZoomControls (boolean enabled) 
setCacheMode (int mode) 
setDefaultFontSize(int size) 
setDefaultTextEncodingName (String encoding) 
setDisplayZoomControls (boolean enabled) 
setJavaScriptEnabled (boolean flag) 
setSupportZoom(boolean support) 


3. WebView 浏 览 


在 WebView 中 浏览 加 载 网 页 采用 两 种 方式 ， 分 别 是 : 


Void 
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loadUrl (String url) 


允许 或 禁止 访问 文件 数据 

是 否 显示 网 络 图 像 

是 否 支持 缩放 

设置 缓存 模式 
设置 默认 字体 大 小 

设置 默认 编码 

设置 是 否 使 用 缩放 按钮 
设置 是 否 支持 uavaScript 
设置 是 否 支 持 缩放 
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直接 加 载 网 页 、 图 片 并 显示 ， 对 于 网 页 中 柑 套 的 图 片 地 址 也 将 加 载 地 址 并 显示 图 片 ， 


参数 为 网 络 地 址 ; 


void loadData(String data, String mimeType, String encoding) 


显示 网 页 中 的 文件 和 图 片 ， 对 于 网 页 中 嵌 套 的 地 址 不 会 显示 。 其 中 ， 参 数 data 是 显示 
的 数据 ;参数 mimeType 是 文件 类 型 ， 参 数 encoding 是 编码 方式 。 
熟悉 了 WebView 的 基本 使 用 ， 实 现 一 启动 就 访问 百度 页 面 的 浏览 器 代码 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
六 
浊 
13 
14 
5 
16 
和 
18 
9 
20 
2 


webView = (WebView) findViewById(R.id.webview); 
// 得 到 Websetting 对 象 ， 设 置 支持 JavaScript 的 参数 
webView.getSettings () .setJavaScriptEnabled (true); 
// 设 置 可 以 支持 缩放 
webView.getSettings () .setSupportZoom (true) 
// 设 置 默 认 缩放 方式 为 FRR 
webView.getSettings () .setDefaultZoom(ZoomDensity .FAR); 
// 设 置 出 现 缩放 工具 
webView.getSettings () .setBuiltInZoomControls (true); 
// 载 入 URL 
webView.loadUrl ("http://www.baidu.com"); 
// 使 页 面 获得 焦点 
webView.requestFocus () ; 
// 给 按钮 绑 定单 击 监听 器 
btn visit.setOnClickListener (new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
// 访 问 编辑 框 中 的 网 址 
webView.loadUrl ("http://" + edt url.getText () .toString()); 
} 
有 这 


实现 效果 如 图 5.20 所 示 。 但 是 当 我 们 在 输入 框 中 输入 地 址 时 ， 单 击 “ 转 到 ”按钮 会 使 
用 默认 的 浏览 器 加 载 网 页 ， 不 会 在 我 们 的 WebView 中 加 载 。 以 访问 developer.android.com 
为 例 ， 效 果 如 图 5.21 所 示 。 
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5.7.2 ”网 页 事件 处 理 
如 何 才能 让 跳 转 的 网 页 在 我 们 的 WebView 中 显示 呢 ? 这 里 就 必须 使 用 到 WebView 的 
另外 两 个 辅助 对 象 : WebViewClient 和 WebChromeClient。 


1. WebViewClient 


其 中 , WebViewClient 用 来 帮助 WebView 处 理 各 种 通知 、 请求 事件 等 WebViewClient 
中 提供 的 常用 方法 如 下 : 


void doUpdateVisitedHistory (WebView view, String url, boolean isReload) 


更 新 历史 记录 
void onFormResubmission (WebView view, Message dontResend, Message resend) 
重新 请 求 网 页 数据 
void onPageFinished(WebView view, String url) 网 页 加 载 完 毕 


void onPageStarted (WebView view，String url，Bitmap favicon) 网 页 开始 加 载 
Void onReceivedError (WebView view, int errorCode, String description, String 


failingUrl) 报告 错误 信息 

void onScaleChanged (WebView view, float oldScale, float newScale) 
WebView 发 生 改变 

boolean shouldOverrideKeyEvent (WebView view, KeyEvent event) 


控制 新 连接 在 当前 WebView 中 打开 


在 这 里 我 们 不 需要 在 页 面 加 载 时 做 任何 处 理 ， 只 需要 控制 新 的 连接 在 当前 WebView 
中 打开 即 可 ， 也 就 是 说 我 们 只 需要 重 写 shouldOverrideUrlLoading() 方 法 ， 实 现 如 下 : 


01 // 创 建 vebviewclient， 实 现 只 有 在 webview 中 响应 URL， 不 使 用 默认 浏览 器 

02 webView.setWebViewClient (new WebViewClient() { 

03 override 

04 Public boolean shouldOverrideUrlLoading (WebView view, 
String url) { 

05 Toast.makeText (context, "webvc shouldOverrideUr- 

lLoading", 1000).show(); 

06 // 使 用 自己 的 webview 加 载 

07 View.loadUr]l (ur1) : 

08 return true; 

09 } 

10 DD); 


其 中 ，02 行 ， 设 置 WebView 的 通知 请 求 处 理 辅 助 类 WebViewClient; 

03 一 04 行 ， 重 写 WebViewClient 类 的 方法 shouldOverrideUrlLoading()， 在 方法 中 实现 
新 的 连接 在 当前 WebView 中 打开 ; 

07 一 08 行 ， 在 当前 WebView 中 加 载 页面 ， 返 回 tue。 实 现 效果 如 图 5.22 所 示 。 


2. WebChromeClient 








WebChromeClient 用 于 辅助 WebView 处 理 JavaScript 的 对 话 框 、 网 站 图 标 、 网 站 标题 、 
加 载 进度 等 。WebChromeClient 中 的 常用 方法 有 : 
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图 5.22 ”当前 WebView 加 载 中 


void onCloseWindow (WebView window) // 关 闭 WebView 

boolean onCreateWindow (WebView view, boolean dialog, boolean 
userGesture, Message resultMsg) // 创 建 WebView 

boolean onJsAlert (WebView view, String url, String message, JsResult 
result) // 处 理 JavaScript 中 的 Alert 对 话 框 
boolean onJsConfirm(WebView view, String url, String message, JsResult 
result) // 处 理 JavaScript 中 的 Comfirm 对 话 框 
boolean onJsPrompt (WebView view, String url, String message, String 


defaultValue，JsPromptResult result)  // 处 理 JavaScript 中 的 Prompt 对 话 框 
void onProgressChanged (WebView view，int newProgress) // 加 载 进 度 条 改变 


void onReceivedIcon (WebView view, Bitmap icon) // 网 页 图 标 改变 
void onReceivedTitle (WebView view, String title) // 网 页 标题 改变 


在 我 们 的 浏览 器 中 ， 比 较 简 单 没有 访问 有 JavaScript 对 话 框 的 网 页 ， 在 这 里 实现 网 页 
加 载 过 程 中 进度 条 的 修改 ， 实 现 如 下 : 


01 // 进 度 条 

02 final Activity activity = this; 

03 webView.setWebChromeClient (new WebChromeClient() { 
04 Q@Override 

05 public void onProgressChanged (WebView view, int newProgress) { 
06 activity.setTitle ("加 载 中 。。。"); 

07 if (newProgress == 100) { 

08 activity.setTitle(R.string.app name); 
09 } 

10 } 

el Ds 


其 中 ，03 行 ， 设 置 WebView 的 通知 请 求 处 理 辅助 类 WebChromeClient; 

05 一 10 行 , 重 写 WebChromeClient 类 的 方法 onProgressChanged0， 在 方法 中 实现 在 页 
面 加 载 过 程 中 ， 将 应 用 程序 的 标题 修改 为 “加 载 中 …”， 加 载 完 成 后 ， 程 序 标题 又 修改 回 
初始 标题 ， 实 现 效果 如 图 5.22 所 示 。 
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3. 网 页 回 退 


除了 以 上 两 个 辅助 类 之 外 ,我们 最 常用 的 是 处 理 网 页 回 退 事件 。 当 我 们 使 用 WebView 
eis 如 果 不 做 任何 处 理 ， 单 击 系统 的 Back 键 ， 整 个 浏览 器 会 调用 finishO 

结束 自身 。 而 我 们 习惯 用 Back 键 来 实现 浏览 的 网 页 回 退 而 不 是 退出 浏览 器 ， 所 以 我 们 
en 前 Activity 中 处 理 并 取消 该 Back 事件 。 这 个 过 程 实现 简单 ， 具 体 如 下 : 


01 // 设 置 默 认 后 退 按钮 为 返回 前 一 页 面 











02 webView. setOnKeyListener (new OnKeyListener() { // 键 盘 监 听 
03 @Override 
04 Public boolean onKey (View v, int keyCode, KeyEvent event) { 
05 if (event.getAction() 一 KeyEvent.ACTION DOWN) { 
// 键 盘 按 下 动作 
06 if ((keyCode == KeyEvent.KEYCODE BACK) && webView. 
canGoBack()) { 
07 webView.goBack (); // 回 退 
08 return true; 
09 } 
10 
El return false; 
12 } 
13 | 


其 中 ，02 行 ， 设 置 WebView 的 按键 监听 事件 ; 
03 一 11 行 ， 重 写 onKey， 当 发 现 按 键 为 Back 键 并 且 网 页 可 以 回 退 时 ， 回 退 网 页 。 这 
样 就 屏 顽 了 系统 的 Back 按键 ， 不 会 直接 退出 浏览 器 。 实 现 效果 如 图 5.22 所 示 。 


5.7.3 网 页 拍照 


在 前 面 ， 我 们 已 经 实现 了 浏览 器 常用 的 浏览 、 设 置 、 当 前 WebView 加 载 、 进 度 条 、 
网 页 回 退 等 事件 处 理 ， 这 些 都 是 一 般 浏览 器 带 有 的 功能 。 接 下 来 ， 我 们 实现 一 个 网 页 拍照 
的 功能 ， 将 浏览 的 网 页 保持 为 图 片 格式 ， 步 又 如 下 : 

(1) 在 界面 中 添加 “保存 网 页 为 图 片 ” 按 钮 ， 如 图 5.23 所 示 。 
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图 5.23 网 页 拍照 
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(2) 在 AndroidManifestxml 文件 中 申请 在 SD 卡 创建 写 入 文件 的 权限 ， 如 下 : 
<!-- 在 SD 卡 中 创建 与 删除 文件 权限 --> 


<uses-permission 
android:name="android.permission.MOUNT UNMOUNT FILESYSTEMS" /> 


<!-- 往 SD 卡 写 入 数据 权限 --> 
<uses-permission 
android:name="android.permission.WRITE EXTERNAL STORAGE" /> 


(3) 在 WebView 中 提供 保存 当前 显示 内 容 为 图 片 的 方法 : 

Picture capturePicture () 

其 中 ， 返 回 值 为 图 片 类 Picture。 对 于 图 片 的 绘制 实现 中 ， 使 用 到 的 画布 类 Canvas 以 
及 绘制 的 draw 方法 ， 这 些 内 容 将 在 多 媒体 章节 中 详细 讲解 。 

使 用 上 述 的 方法 ， 我 们 就 可 以 实现 网 页 拍照 的 功能 ， 将 图 片 保存 在 SD 卡 中 ， 有 具体 实 
现 如 下 : 

01 // 保 存 页 面 截图 





D2 btn save.setonClickListener(new OnClickListener() { 

03 @Override 

04 public void onClick(View v) { 

05 Picture pic = webView.capturePicture(); // 网 页 截图 

06 int width = pic.getwidth(); // 获 取 图 片 宽度 

07 int height = pic.getHeight (); // 获 取 图 片 高 度 

08 if (width > 0 && height > 0) { // 创 建 图 片 类 

09 Bitmap bmp=Bitmap.createBitmap (width, height, Bitmap. 

Config.ARGB 8888); 

10 Canvas canvas=new Canvas (bmp); // 初 始 化 画布 

11 pic.draw (canvas); // 绘 制图 像 

U2 // 保 存 

3 try { 

14 String filename="sdcard/"+System.currentTime— 
Millis()+".jpg"; // 保 存 路 径 

15 FileOutputStream fos=new FileOutputStream 
(filename); // 获 取 文 件 输出 流 

16 fi(Fosl nan) // 图 片 数 据 写 入 文件 

17 bmp. compress (Bitmap.CompressFormat .JPEG, 90, fos); 

18 fos.close(); // 关 闭 数据 流 

19 } 

20 Toast .makeText (context，" 截 图 成 功 ， 文 件 名 为 : 
"+filename, 1000) .show() > 

lt } catch (Exception e) { 

2 e.printSstackTrace () 

23 } 

24 1 

Fl } 

26 Ey 


其 中 ，05 行 ， 实 现 拍照 ， 将 当前 WebView 显示 内 容 保 存 为 Picture; 

09~-11 行 ， 将 Picture 绘制 到 画布 容器 中 ; 

13 一 19 行 ， 保 存 图 片 内 容 到 SD 卡 中 ， 保 存 为 jpg 格式 的 文件 。 实 现 效果 如 图 5.23 
所 示 。 
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5.7.4 ”分析 总 结 


通过 上 面 这 些 步骤 ， 我 们 已 经 实现 了 一 个 简易 的 浏览 器 ， 并 且 可 以 通过 该 浏览 器 将 需 
要 保存 的 网 页 即时 地 拍照 保存 。 通 过 查看 Eclipse 中 DDMS 界面 中 的 File Explorer 选项 卡 ， 
可 以 看 到 SD 卡 中 保存 的 文件 目录 如 图 5.24 所 示 。 
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图 5.24 保存 的 目录 


将 保存 的 图 片 文件 导出 到 PC 中 ， 使 用 图 片 查看 器 打开 ， 显 示 如 图 5.25 所 示 。 可 以 看 
出 与 我 们 在 5.23 中 看 到 的 图 片 相同 。 
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图 5.25 保存 的 页 面 
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在 这 一 节 中 ， 我 们 使 用 WebView 控件 实现 了 简易 的 浏览 器 。 其 中 ， 主 要 使 用 到 了 与 
WebView 相关 的 4 个 类 : WebView 主要 负责 解析 、 演 染 网 页 ，WebSettings 用 于 设置 
WebView 显示 的 基本 属性 ; WebViewClient 用 于 处 理 各 种 通知 、 请 求 事件 ; WebChromeClient 
用 于 处 理 网 页 中 JavaScript 的 对 话 框 、 网 站 图 标 、 网 站 标题 、 加 载 进度 等 。 

















5.8 ” WiFi 管理 


在 前 面 的 章节 中 ， 我 们 已 经 通过 具体 的 实例 讲解 了 在 Android 系统 中 网 络 编程 的 6 种 
最 常用 方式 ， 但 是 由 于 Android 系统 一 般 用 于 系统 设备 ， 接 入 网 络 的 方式 并 不 是 PC 常见 
的 有 线 接 入 ， 而 是 采用 无 线 方式 接 入 网 络 。 而 WiFi 在 全 球 范围 内 都 是 作为 无 需 任何 电信 
运营 执照 的 免费 频段 ， 可 以 提供 一 个 世界 性 的 、 费 用 低廉 且 数据 带宽 高 的 网 络 接口 ， 通 过 
WiFi， 我 们 可 以 方便 地 使 用 网 络 。 

在 Android 中 提供 了 android.net.wifi 包 来 实现 应 用 程序 对 WiFi 的 接 入 管理 , 包括 已 接 
入 WiFi 网 络 的 信号 强度 、 名 称 、MAC、 了 地 址 等 信息 以 及 扫描 、 保 存 、 连 接 等 操作 。 下 
面 ， 我 们 实现 扫描 WiFi、 显 示 已 接 入 WiFi 的 信息 。 

在 模拟 器 中 ， 由 于 硬件 模拟 方面 的 不 支持 ， 是 不 能 测试 WiFi 相关 程序 的 ， 所 以 必须 
使 用 真 机 进行 测试 。 界 面 非 常 简单 ， 最 上 面 一 栏 显示 已 经 连接 的 WiFi 信息 ， 然 后 是 用 于 
打开 WiFi、 扫 描 附 近 WiFi 热点 和 连接 WiFi 功能 的 3 个 按钮 ， 最 后 是 ListView 的 显示 结 
果 ， 效 果 如 图 5.26 所 示 。 




















wifi 已 打开 县 扫描 可 用 的 Wifi 连 接 


CCMP][WPA2-PSK-CCMP- 
preauth], level: -71, frequency: 


2457 

编号 2 :SSID: TP-LINK_46A84E, 
BSSID: f4:ec:38:46:a8:4e, 
capabilities: [WPA-PSK- 
CCMP][WPA2-PSK-CCMP- 
preauth], level: -99, frequency: 
2442 

编号 3 :SSID: TP-LINK_II, BSSID: 
e0:05:c5:a2:bd:96, capabilities: 





图 5.26 扫描 结果 


1. 权限 申请 


在 使 用 WiFi 之前， 必须 申请 权限 ， 实 现 如 下 : 


<uses-permission android:name="android.permission.ACCESS WIFI STATE"/> 
<uses-permission android:name="android.permission.WAKE LOCK"/> 
<uses-permission android:name="android.permission.CHANGE WIFI STATE"/> 
<uses-permission android:name="android.permission.CHANGE NETWORK STATE" /> 
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<uses-permission 
android:name="android.permission.ACCESS NETWORK STATE"/> 
<uses-permission android:name="android.permission.INTERNET"/> 


2. 扫描 WiFi 


在 Android 中 ， 对 于 WiFi 的 任何 管理 ， 都 很 好 地 封装 在 了 一 个 WifiManager 类 中 ， 对 
于 大 部 分 WiFi 相关 的 管理 操作 都 可 以 通过 它 来 完成 。 
(1) WifiManager 
获取 WifiManager 非常 简单 ， 使 用 Context 类 的 getSystemService0 即 可 ， 具 体 实 现 
如 下 : 


WifiManager mWifiManager = (WifiManager) Context.getSystemService 
(Context .WIFI_SERVICE) 


WifiManager 可 以 完成 很 多 操作 ， 包 括 : 

口 扫描 WiFi 接 入 点 ， 并 提供 足够 详细 的 扫描 结果 信息 ， 以 便 用 户 决 定 连接 点 。 
口 对 于 已 连接 的 WiFi， 可 以 关闭 连接 ， 查 询 相关 的 网 络 P、DNS 等 动态 信息 。 
口 对 于 配置 好 的 网 络 清单 可 以 进行 查看 、 修 改 。 

口 定义 了 标识 WiFi 状态 的 常量 。 

对 于 这 些 操作 都 有 具体 的 方法 来 实现 ， 常 用 的 方法 有 : 








Wifi 开启 关闭 设置 : 

boolean isWifiEnabled() WiFi 是 否 可 用 
boolean setWifiEnabled (boolean enabled) 设置 WiFi 是 否 可 用 
WiFi 扫描 : 

boolean startScan() 扫描 WiFi 


List<ScanResult> getScanResults () 

其 中 , 返回 值 为 扫描 的 结果 ScanResult 类 , 包括 了 扫描 到 的 WiFi 的 名 称 、MAC 地 址 、 
信号 强度 、 频 率 等 信息 。 

已 连接 WiFi 信息 : 

WifiInfo getConnectionInfo() 

其 中 ， 返 回 值 为 连接 WiFi 信息 WifInfo 类 ， 包 括 了 连接 到 的 WiFi 的 名 称 、IP 地 址 、 
MAC 地 址 、 速 度 、 网 络 编号 等 信息 。 

网 络 信息 : 

DhcpInfo getDhcpInfo() 

其 中 ,返回 值 为 连接 的 WiFi 的 DHCP (动态 主机 配置 协议 ) 信息 ， 如 果 当 前 未 连接 到 
WiFi 则 返回 上 次 连接 时 的 信息 。 

已 保存 网 络 清单 : 

List<WifiConfiguration> getConfiguredNetworks () 

其 中 ， 返 回 值 为 在 客户 端 所 有 已 经 配置 完成 的 WiFi 配置 信息 WiiConfiguration 类 ， 
包括 了 WiFi 网 络 的 名 称 、MAC 地 址 、 密 码 、 编 号 等 信息 。 
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连接 WiFi: 
boolean enableNetwork (int netId, boolean disableOthers) 


其 中 ， 参 数 netId 为 保存 的 配置 WifiConfiguration 类 的 编号 ， 参 数 disableOthers 为 是 
否 断 开 其 他 连接 标识 ; 返回 值 为 是 否 连接 成 功 。 














对 于 扫描 WiFi 热 点， 我 们 可 以 很 方便 地 使 用 上 述 方法 来 实现 ， 有 具体 实现 如 下 : 

01 // 查 看 扫描 结果 

02 private List<String> Scan info() { 

03 StringBuilder sBuilder = new StringBuilder(); 

04 List<String> scanList = new ArrayList(); 

05 List<ScanResult> mWifi list; // 定 义 扫描 结果 

06 mWifiManager = (WifiManager) Context.getSystemService (Context. 
WIFI SERVICE); // 获 取 WiFi 管理 器 

07 if (!ImWifiManager.isWifiEnabled()) { //WiFi 不 可 用 

08 return scanList; 

09 下 

10 // 扫 描 

则 王 mWifiManager.startScan(); 

i // 得 到 扫描 结果 

pl mWifi list = mWifiManager.getScanResults(); 

14 Eor (Mint i = O07 1 < mmifi ldst slzdl)y EI) 

15 sBuilder.append ("编号 " + new Integer(i + 1) .toString() 

+m :nm) 7 

16 //scanresult 信息 

hy sBuilder.append( (mWifi list.get(i)).tostring()); 

18 scanList.add(sBuilder.tosString()); 

19 sBuilder.setLength (0); 

20 下 

21 return scanList; 

22 } 


其 中 ，01 一 05 行 ， 定 义 、 初 始 化 用 到 的 变量 ; 

06 行 ， 从 Context 中 通过 系统 服务 获得 WifManager; 

07 一 09 行 ， 判 断 Android 设备 的 WiFi 是 否 打开 ， 没 有 打开 则 返回 扫描 结果 为 空 ; 

10 一 11 行 ， 开 始 扫描 设备 周边 的 WiFi 接 入 点 ; 

12 一 20 行 ， 获 得 扫描 结果 ， 并 且 将 扫描 的 结果 以 String 数组 的 形式 返回 。 

(2) 结果 显示 

对 于 这 些 结果 ， 我 们 以 最 简单 的 ListView 进行 显示 ， 在 前 面 的 章节 中 ， 我 们 已 经 可 以 
熟练 使 用 它 ， 具 体 实现 如 下 ， 实 现 效 果 如 图 5.26 所 示 。 

List<String> scan infoList = Scan info(); 

// 设 置 1ist 显示 


list.setAdapter (new ArrayAdapter<String> (context, 
android.R.layout.simple list item 1, scan infoList)); 


3. 连接 WiFi 
在 实际 项 目 中 , 除了 扫描 WiFi 热点 之 外 , 我 们 更 常用 的 是 尝试 连接 在 Android 设备 中 


已 经 保存 了 的 WiFi 热点 ， 这 样 对 于 加 密 的 WiFi， 只 要 我 们 登录 过 一 次 ， 下 一 次 就 可 以 自 
动 登录 。 使 用 上 述 WifiManager 中 的 方法 ， 具 体 实现 如 下 : 
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01 mWifiConfigurations = mWifiManager.getConfiguredNetworks(); 
// 获 取 已 有 WiFi 配置 

02 if (mWifiConfigurations.size() > 0) { 

03 // 尝 试 打开 WiFi 服务 

04 if (!mWifiManager.isWifiEnabled()) { 

05 if (mWifiManager.getWifistate() != WifiManager.WIFI STATE 

ENABLING) { 

06 mWifiManager.setWifiEnabled (true); // 开 启 WiFi 

07 } 

08 } 

09 

10 // 尝 试 连接 ， 直 到 成 功 连 接 或 全 部 失败 

在 二 for (WifiConfiguration amTask : mWifiConfigurations) { 
// 遍 历 已 有 而 Fi 配置 

4 int intNetworkID = amTask.networkId; 

0 // 通 过 enableNetwork 连接 至 该 无 线 网 络 设置 

14 if (mWifiManager.enableNetwork (intNetworkID, true)) { 

15 return; 

16 } 

EG } 


其 中 ，01 行 ， 获 取保 存 的 已 连接 清单 ; 


04 一 08 行 ， 判 断 WiFi 是 否 可 用 ， 不 可 用 则 开启 WiFi; 
09 一 17 行 ， 根 据 清单 中 保存 的 所 有 WiFi 连接 配置 信息 ， 对 其 逐个 进行 尝试 ， 直 到 连 
接 成 功 为 止 ， 实 现 效果 如 图 5.27 所 示 。 


CR 会 昨 夯 47:35 


I 4 1 
WiFi 已 打开 县 扫描 可 用 的 WiFi 连 接 


连接 网 络 成 功 ， 编 号 为 0 





图 5.27 WiFi 连接 成 功 


4. 总 结 


对 WiFi 的 管理 ， 在 实际 项 目的 开发 过 程 中 ， 都 是 作为 一 个 完整 的 网 络 项 目 中 的 第 一 
步 ， 只 有 成 功 连接 到 无 线 网 络 才能 顺利 地 访问 网 络 ， 才 能 使 用 前 面 章节 介绍 的 网 络 访问 方 
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式 ， 所 以 WiFi 的 连接 管理 就 非常 重要 。 另 一 方面 ， 由 于 Android 提供 给 我 们 WifiManager 
以 及 丰富 的 方法 , 我 们 的 应 用 程序 可 以 方便 快捷 地 连接 到 WiFi, 实现 WiFi 管理 也 不 复杂 。 
当然 ， 由 于 模拟 器 的 不 支持 ， 这 部 分 的 测试 必须 在 真 机 上 进行 。 





5.9 蓝牙 聊天 


除了 上 述 的 连接 到 Internet 网 络 的 网 络 通 信之 外 ， 在 Android 2.0 以 上 版 本 的 设备 上 同 
样 支持 较 近 距离 的 无 线 通信 方式 蓝牙 通信 。 

在 Android 中 提供 了 android.bluetooth 包 来 进行 蓝牙 的 相关 操作 ， 主 要 实现 打开 蓝牙 
关闭 蓝牙 、 搜 索 附近 蓝牙 设备 以 及 蓝牙 数据 通信 等 功能 。 在 这 一 节 中 ， 我 们 通过 蓝牙 来 实 
现 两 部 Android 设备 之 间 的 通信 聊天 功能 

蓝牙 和 WiFi 一 样 ， 在 模拟 器 中 ， 由 于 硬件 入 拟 方面 的 不 支持 ， 是 不 能 测试 蓝牙 相关 
程序 的 ， 所 以 必须 使 用 真 机 进行 测试 。 其 界面 非常 简单 ， 在 标题 栏 的 右边 给 1 了 

















连接 的 状态 : connected、connecting... 和 not connected; 在 最 底部 有 需要 发 送 消息 
以 及 发 送 按钮 ， 中间 预 留 出 最 大 空间 的 部 分 为 已 有 聊天 消息 ， 效 果 如 图 5.28 所 计 示 。 





图 5.28 ”蓝牙 聊天 


当然 ， 要 使 用 蓝牙 设备 ， 需 要 在 AndroidManifest xml 文件 中 申请 权限 ， 如 下 所 示 : 


<uses-permission android:name="android.permission.BLUETOOTH ADMIN" /> 
<uses-permission android:name="android.permission.BLUETOOTH" /> 


5.9.1 蓝牙 搜索 


我 们 平时 在 使 用 蓝牙 的 时 候 都 知道 ， 首 先 需要 搜索 、 配 对 蓝牙 才能 传输 数据 。 在 蓝牙 
聊天 中 , 同样 需要 这 些 步 又 。 接 下 来 我 们 来 开启 蓝牙 和 搜索 蓝牙 设备 , 实现 的 效果 如 图 5.29 
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和 图 5.30 所 示 。 


device to connect 
Palred Devlces 


@ 蓝牙 权限 请 求 


您 手机 上 的 某 一 应 用 程序 正在 请 
求 相 应 权限 以 便 打开 蓝牙 。 您 是 
否 要 允许 ? 


E 
Scan for devices 





图 5.29 ”请求 开 启 蓝牙 图 5.30 扫描 蓝牙 界面 


启 蓝 牙 


人 


:开启 蓝牙 的 过 程 中 ， 我 们 需要 如 下 3 步 : 

1) 获取 本 地 的 蓝牙 设备 ， 使 用 BluetoothAdapter 类 的 方法 : 
BluetoothAdapter getDefaultAdapter () 

其 中 ， 返 回 为 本 地 蓝牙 设备 句柄 ， 如 果 本 地 没有 蓝牙 设备 则 返回 为 null。 
(2) 判断 蓝牙 是 否 开 启 可 用 ， 使 用 BluetoothAdapter 类 的 方法 : 

oolean isEnabled() 

中 ， 当 蓝牙 开启 并 可 用 时 返回 真 ， 耕 则 返回 假 。 

(3) 请 求 开 启 蓝牙 

我 们 可 以 不 询问 直接 开启 蓝牙 设备 ， 使 用 BluetoothAdapter 类 方法 : 
boolean enable () 

当然 ， 为 了 给 用 户 一 个 提示 ， 可 以 调用 系统 的 开启 蓝牙 询问 ， 方 法 如 下 ; 


Intent enableIntent = new Intent (BluetoothAdapter.ACTION REQUEST ENABLE); 
startActivityForResult (enableIntent, REQUEST ENABLE BT) 


这 





站 





其 中 ，BluetoothAdapter.ACTION _ REQUEST _ ENABLE 是 用 于 调用 系统 允许 界面 的 意 
图 动作 ， 实 现 的 效果 如 图 5.29 所 示 。 整 个 过 程 实现 代码 如 下 


01 // 获 取 本 地 蓝牙 适配器 

02 mBluetoothAdapter = BluetoothAdapter .getDefaultAdapter (); 

03 // 获 取 失 败 

04 if (mBluetoothAdapter == nul]l) { 

05 Toast.makeText (this, "Bluetooth is not available", Toast. 
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LENGTH LONG) -show() 


06 return; 

07 } 

08 // 开 启 蓝牙 

09 If (!ImBluetoothAdapter.isEnabled()) { 

10 Intent enableIntent = new Intent (BluetoothAdapter.ACTION 
REQUEST ENABLE); 

生生 startActivityForResult (enableIntent, REQUEST ENABLE BT); 

// 跳 转 到 开启 蓝牙 界面 
下 人 } 


其 中 ，01 一 02 行 ， 获 取 本 地 的 蓝牙 适配器 ; 
03 一 07 行 ， 获 取 失 败 ， 则 给 出 提示 并 返回 ; 
08 一 12 行 ， 请 求 开启 蓝牙 。 


2. 搜索 蓝牙 
在 搜索 蓝牙 时 ， 我 们 需要 在 一 个 新 的 界面 中 ， 显 示 本 机 已 经 保存 过 的 已 配对 蓝牙 设备 
和 搜索 结果 。 其 中 ， 搜 索 界面 如 图 5.30 所 示 ， 菜单 as 5.31 所 示 ， 搜 索 结果 如 图 5.32 
所 示 。 这 些 界面 布局 都 比较 简单 ， 





FD:E 
Other Avallable Devices 


yund 


/A 





Connect a device Make discoverable 
图 5.31 菜单 界面 图 5.32 搜索 结果 


在 搜索 蓝牙 设备 时 ， 显 示 的 结果 包括 了 已 保存 的 配对 蓝牙 设备 和 附近 其 他 已 开启 的 蓝 
牙 设备 两 部 分 内 容 。 

(1) 已 保存 配对 蓝牙 

获取 在 本 地 保存 的 蓝牙 设备 信息 ， 通 过 BluetoothAdapter 类 的 方法 : 


Set<BluetoothDevice> getBondedDevices () 





其 中 ， 返 回 值 为 BluetoothDevice 类 的 集合 。 在 BluetoothDevice 中 ， 了 蓝牙 设备 
的 名 称 、 地 址 、 配 对 状态 、 描 述 等 信息 。 因 此 ， we 设备 的 信息 实 
现 如 下 : 
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01 // 获 取 蓝 牙 适 配器 

02 mBtAdapter = BluetoothAdapter .getDefaultadapter () 

03 // 获 取 已 保存 的 配对 设备 

04 Set<BluetoothDevice> pairedDevices = mBtAdapter. 
getBondedDevices(); 

05 if (pairedDevices.size() > 0) { 

06 for (BluetoothDevice device : pairedDevices) {// 遍 历 已 保存 配对 

07 mPairedDevicesArrayAdapter.add(device.getName() + "\n" + 

device.getAddress () ) : // 显 示 结 果 

08 } 

09 else { 

10 mPairedDevicesArrayAdapter.add ("No devices have been paired"); 

11 } 


其 中 ，01 一 02 行 ， 获 取 本 地 的 蓝牙 适配器 ; 

03 一 04 行 ， 获 取 本 地 保存 的 已 配对 蓝牙 设备 ; 

05 一 08 行 ， 如 果 清 单 中 有 设备 ， 则 显示 设备 的 名 称 和 地 址 。 实 现 效果 如 图 5.30 所 示 。 
(2) 搜索 蓝牙 

在 搜索 过 程 中 ， 如 果 此 时 蓝牙 正在 搜索 ， 则 关闭 此 次 搜索 重新 开始 搜索 附近 的 蓝牙 设 
使 用 BluetoothAdapter 类 的 方法 : 


boolean isDiscovering () // 本 地 蓝牙 是 否 正 在 搜索 
boolean cancelDiscovery () // 取 消 当 前 搜索 
boolean startDiscovery() // 开 始 搜索 


整个 过 程 实现 如 下 


01 // 已 经 扫描 

02 if (mBtAdapter.isDiscovering()) { 

03 mBtAdapter .cancelDiscovery (); // 关 闭 搜 索 
04 } 

05 // 重 新 开启 扫描 

06 ImBtRAdapter.startDiscovery() : 


其 中 ，02 行 ， 判 断 蓝 牙 是 否 正 在 搜索 附近 的 蓝牙 设备 ; 

03 行 ， 当 正在 搜索 时 ， 关 闭 当 前 搜索 ; 

06 行 ， 开 始 一 个 新 的 蓝牙 搜索 。 

在 搜索 蓝牙 设备 的 时 候 ， 和 我 们 使 用 的 WiFi 不 一 样 ， 它 是 使 用 广播 来 通知 搜索 结果 。 


当 搜 索 到 蓝牙 设备 时 , 发 送 广播 动作 BluetoothDevice.ACTION_FOUND, 而 当 搜 索 完成 时 ， 
发 送 广播 动作 BluetoothAdapter ACTION _ DISCOVERY FINISHED。 所 以 ， 我 们 通过 监听 
这 两 个 广播 动作 来 获取 搜索 的 结果 : 


// 注 册 扫 描 广播 

IntentFilter filter = new IntentFilter (BluetoothDevice.ACTION FOUND) 
this.registerReceiver (mReceiver, filter); 

filter = new IntentFilter (BluetoothAdapter.ACTION DISCOVERY FINISHED); 
this.registerReceiver (mReceiver, filter); 


在 接收 广播 时 ， 我 们 针对 搜索 到 蓝牙 设备 和 搜索 完成 两 个 不 同 的 动作 ， 分 别 实现 添加 


非 配对 设备 和 结束 搜索 更 新 UI 界面 功能 。 具 体 实现 如 下 : 


01 Public void onReceive (Context context, Intent intent) { 
02 String action = intent.getAction(); 
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03 // 发 现 设备 
04 if (BluetoothDevice.ACTION FOUND .equals (action)) { 
05 BluetoothDevice device = intent.getParcelableExtra 
(BluetoothDevice.EXTRA DEVICE); 
06 // 添 加 非 配对 设备 
07 if (device.getBondState () != BluetoothDevice.BOND BONDED) { 
08 mNewDevicesArrayAdapter.add (qdevice .getName () + "\n" + 
device.getAddress ()); 
09 } 
10 // 扫 描 结束 时 ， 更 新 UI 
es } else If (BluetoothAdapter.ACTION DISCOVERY FINISHED.equals 
(action)) { 
过 setProgressBarIndeterminateVisibility(false) 7 
// 设 置 进度 条 不 可 见 
13 setTitle("select a device to connect"); // 设 置 标题 
14 if (mNewDevicesArrayAdapter.getCount() == 0){ 
// 判 断 是 否 搜索 到 新 设备 
ES String noDevices = "No devices found"; 
16 mNewDevicesArrayAdapter.add (noDevices); 
7 } 
18 } 
i 


其 中 ，04 一 09 行 ， 判断 广播 动作 为 搜索 到 蓝牙 设备 ， 从 广播 信息 中 获取 搜索 到 的 蓝牙 
设备 信息 ， 如 果 该 设备 没有 在 本 地 配对 则 添加 到 新 设备 列表 中 ; 

10 一 18 行 ， 当 结束 搜索 广播 时 ， 改 变 进度 条 和 标题 栏 ， 判 断 是 否 搜索 到 新 蓝牙 设备 ， 
如 果 没 有 新 设备 则 显示 没有 发 现 新 设备 。 效 果 如 图 5.32 所 示 。 


5.9.2 ”聊天 通信 


在 前 面 的 5.3 节 中 ， 我 们 也 实现 了 一 个 基于 UDP 的 即时 聊天 程序 ， 和 本 节 在 整体 的 设 
计 思 路 上 是 一 致 的 ， 包 括 了 服务 器 端 和 客户 端 ， 只 是 在 实现 时 使 用 的 具体 技术 方法 上 存在 
差别 。 
1， 服 务 器 端 


在 蓝牙 通信 中 和 TCP 通信 一 样 包括 了 BluetoothServerSocket 和 BluetoothSocket 两 种 
Socket 类 型 。 在 服务 器 端 使 用 BluetoothServerSocket 来 等 待 客户 端的 接 入 ， 创 建 
BluetoothServerSocket， 使 用 BluetoothAdapter 类 的 方法 : 


BluetoothServerSocket listenUsingRfcommWithServiceRecord(String name, 

UUID uuid) 

其 中 ， 参 数 name 为 服务 的 名 称 ，uuid 为 服务 的 唯一 标识 号 。 在 本 实例 中 ,创建 
BluetoothServerSocket 实现 如 下 : 


private static final String NAME = "BluetoothChat"; 

private static final UUID MY UUID = UUID.fromString ("fa87c0d0-afac-llde-— 
8a39-0800200c9a66"); 

BluetoothServerSocket mmServerSocket = mAdapter.listenUsingRfcommWith— 
ServiceRecord (NAME, MY UUID); 


创建 完成 了 BluetoothServerSocket 后 ， 等 待 客户 端的 接 入 ， 使 用 方法 : 
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BluetoothSocket accept () 


这 样 就 建立 了 服务 器 端 和 客户 端的 连接 ， 就 可 以 使 用 Socket 进行 通信 。 当 然 ， 在 我 们 
的 实例 中 ， 还 需要 考虑 蓝牙 会 话 线程 通知 UI 线程 进行 界面 更 新 ， 以 及 当前 是 否 有 其 他 蓝 
牙 连 接 等 问题 ， 具 体 实现 如 下 : 
// 本 地 服务 Socket 


Private final BluetoothServerSocket mmServerSocket; 
public AcceptThread() { 





} 





BluetoothServerSocket tmp = null; 
// 创 建 服务 监听 
try { 
tmp = mAdapter.1listenUsingRfcommWithServiceRecord (NAME, MY UUID); 
} catch (IOException e) { 
System.out .println("listen() failed "+e); 
} 


mmServerSocket = tmp; 


BluetoothSocket socket = null; // 定 义 蓝牙 Socket 
// 开 启 服务 监听 
while (mState != STATE CONNECTED) {  // 蓝 牙 末 连接 
try { 
// 等 待 接 入 


socket = mmServerSocket.accept(); 

} catch (IOException e) { 
System.out .println("accept() failed, "+e); 
break; 


} 

// 成 功 建立 连接 

IE (socket != null) { 
Switch (mState) { 
case STATE LISTEN : 
case STATE CONNECTING: 


// 建 立 管理 连接 
connected(socket, socket.getRemoteDevice()); 
// 建 立 蓝牙 连接 
break; 


其 中 ，05 一 11 行 ， 创 建 用 于 监听 的 BluetoothServerSocket 以 及 相应 的 异常 处 理 ; 

12 一 21 行 ， 如 果 当 前 没有 其 他 蓝牙 设备 连接 ， 则 使 用 BluetoothServerSocket 监听 等 待 
客户 端的 接 入 以 及 相应 的 异常 处 理 ; 

22 一 31 行 ， 成 功 连接 之 后 ， 当 状态 为 监听 或 连接 中 时 ， 调 用 connected() 方 法 来 管理 连 
接 。 该 方法 我 们 在 后 面 会 具体 实现 。 


2. 客户 端 

客户 端 与 TCP 的 客户 端的 创建 类 似 ， 首 先 创建 一 个 BluetoothSocket ， 使 用 
BluetoothDevice 类 的 方法 : 

BluetoothSocket createRfcommSocketToServiceRecord (UUID uuid) 


其 中 ,参数 为 服务 的 唯一 标识 。 需要 注意 的 是 此 时 使 用 的 BluetoothDevice 类 代表 的 是 
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服务 器 端的 设备 而 不 是 本 地 蓝牙 设备 。 本 实例 中 ， 在 获取 了 搜索 的 蓝牙 设备 后 ， 从 设备 列 
表 中 获得 对 方 的 MAC 地 址 从 而 创建 蓝牙 设备 BluetoothDevice， 具 体 实现 如 下 : 
String address = data.getExtras () .getString (DeviceListActivity.EXTRA 
DEVICE ADDRESS); 


BluetoothDevice device = mBluetoothAdapter.getRemoteDevice (address); 
BluetoothSocket mmSocket=device.createRfcommSocketToServiceRecord 


(MY UUID); 

创建 客户 端 BluetoothSocket 后 ， 连 接 到 服务 器 端的 方法 是 : 

void connect () 

这 样 就 完成 了 与 服务 器 端的 连接 ， 在 本 实例 中 ， 实 现 如 下 : 

01 private final BluetoothSocket mmSocket; // 定 义 蓝牙 Socket 
02 private final BluetoothDevice mmDevice; // 定 义 蓝牙 设备 

03 public ConnectThread (BluetoothDevice device) {// 连 接 到 蓝牙 的 方法 
04 mmDevice = device; 

05 BluetoothSocket tmp = null; 

06 // 创 建 Socket 

07 try 

08 tmp = device.createRfcommSocketToServiceRecord(MY UUID); 
09 } catch (IOException e) { 

10 e.printSstackTrace (); 

于 王 } 

12 mmSocket = tmp; 

Ee] // 关 闭 “ 可 被 发 现 ”状态 ， 通 信 效 率 更 高 

14 mAdapter.cancelDiscovery(); 

Ny ty 

16 mmSocket.connect (); 

nm // 管 理 连接 

18 connected (mmSocket, mmDevice); 

19 } catch (IOException e) { 

20 try { 

之 于 mmSocket .close(); 

作 交 } catch (IOException e2) { 

23 System.out.println("unable to close() socket during 
connection failure "+e2); 

24 } 

25 1 

26 | 


其 中 ，06 一 12 行 ， 创 建 连接 到 服务 器 端的 BluetoothSocket 以 及 相应 的 异常 处 理 ; 

13 一 25 行 ， 与 服务 器 端 建立 连接 ， 如 果 连 接 成 功 则 调用 connected() 方 法 进行 管理 ， 否 
则 关闭 该 连接 。 

3. 管理 数据 通信 

无 论 是 服务 器 端 还 是 客户 端 在 通信 的 过 程 中 , 都 是 使 用 BluetoothSocket 来 发 送 和 接收 
数据 的 。 而 且 在 数据 通信 等 耗 时 操作 时 ， 为 了 不 影响 UI 界面 与 用 户 交 互 的 流畅 性 ， 这 些 
数据 IO 操作 都 是 另外 开启 一 个 线程 来 处 理 ， 当 界面 更 新 时 ， 需 要 使 用 UI 界面 处 理 线程 的 





Handler 来 传递 消息 。 
首先 ， 从 BluetoothSocket 中 获得 输入 输出 流 ， 使 用 方法 : 
Inputstream getInputStream() 


OutputStream getOutputstream() 


ws 
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当 发 送 数据 时 ， 使 用 输出 流 OutputStream 写 入 ， 方 法 如 下 : 


void 








write(byte[] buffer) 


当 接 收 到 数据 时 ， 使 用 输入 流 InputStream 读 取 ， 方 法 如 下 : 


int read (byte[] b) 


使 用 这 些 方法 ， 实 现 管理 输入 输出 以 及 与 界面 线程 的 通信 ， 有 具体 代码 如 下 : 


01 
02 
03 


“Bs 


// 管 理 连接 线程 ， 发 送 接收 数据 ， 更 新 UI 等 


private class ConnectedThread extends Thread { 


Private final BluetoothSocket mmSocket; // 蓝 牙 Socket 
Private final InputStream mmInStream; // 定 义 输入 流 
private final OutputStream mmOutStream; // 定 义 输出 流 


Public ConnectedThread (BluetoothSocket socket) { 
mmSocket = socket; 
InputStream tmpIn = null; 
OutputStream tmpOut = null; 
try { 
tmpIn = socket.getInputStream(); // 获 取 输 入 流 
tmpOut = socket.getoutputStream();  ”// 获 取 输 出 流 
} catch (IOException e) { 
System.out .println("temp sockets not created"+ e); 
} 
mmInStream = tmpIn; 
ImOutStream = tmpOut; 
} 


public void run() { 
byte[] buffer = new byte[1024];// 数 据 缓存 区 
int bytes; 
// 监 听 输 入 流 
while (true) { 
| 
bytes = mmInStream.read (buffer) ; // 读 取 输 入 流 数据 
// 更 新 UI 
mHandler .obtainMessage (Ex bluechatActivity. 
MESSAGE READ, bytes, 
-1, buffer) .sendToTarget (); 
} catch (IOException e) { 


connectionLost (); // 关 闭 连接 
break; 
} 
} 
// 发 送 数据 
public void write (byte[] buffer) { 
La 
mmOutStream.write (buffer); // 数 据 写 入 输出 流 
// 更 新 UI 


mHandler .obtainMessage (Ex bluechatActivity. 
MESSAGE WRITE, -1, -1, buffer) 
.sendToTarget (); 
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45 } catch (IOException e) { 

46 System-out .println ("Exception during write"+ e); 

47 } 

48 出 

其 中 ，07 一 19 行 ， 是 ConnectedThread 线程 的 构造 函数 ， 获 得 了 BluetoothSocket 中 的 
输入 输出 流 ; 

21 一 36 行 ， 使 用 一 个 永 真 循环 来 不 断 读 取 输 入 的 数据 ， 当 有 输入 时 读 取 数 据 ， 并 交 由 
界面 更 新 显示 ; 


37 一 48 行 ， 写 入 数据 ， 发 送 到 对 方 ， 并 且 在 UI 界面 中 更 新 、 显 示 。 
4. UI 界面 更 新 


在 通信 线程 中 ， 接 收 或 者 发 送 数据 后 ， 需 要 在 UI 界面 上 显示 出 由 谁 发 送 的 什么 数据 ， 
以 便 用 户 清楚 地 知道 聊天 过 程 ， 这 在 UI 线程 中 的 Handler 中 进行 处 理 ， 实 现 如 下 : 


01 private final Handler mHandler = new Handler() { 


02 @Override 

03 public void handleMessage (Message msg) { 

04 switch (msg.what) { 

05 case MESSAGE WRITE: // 发 送 数据 时 

06 byte[] writeBuf = (byte[]) msg.obj; // 获 取信 息 内 容 

07 String writeMessage = new String (writeBuf); 

08 mConversationArrayAdapter.add("Me: " + writeMessage); 
// 添 加 聊天 记录 

09 break; 

10 case MESSAGE READ: // 结 束 数据 时 

LE byte[] readBuf = (byte[]) msg.obj;  ”// 获 取信 息 内 容 

2 String readMessage = new String(readBuf, 0, msg.argl1); 

13 mConversationArrayAdapter .add (mConnectedDeviceName+": 

"+ readMessage); 

14 break; 

15 } 

16 } 

EL }; 


其 中 ，05 一 09 行 ， 当 收 到 MESSAGE_ WRITE 消息 时 ， 读 取 发 送 的 内 容 ， 在 界面 中 显 
示 Me 以 及 发 送 的 内 容 ; 

10 一 15 行 ， 当 收 到 MESSAGE READ 消息 时 ， 读 取 收 到 的 内 容 ， 在 界面 中 显示 发 送 
消息 的 设备 以 及 方式 内 容 。 实 现 的 效果 如 本 节 开 始 的 图 5.28 所 示 。 


5.9.3 总 结 


在 这 一 节 中 ， 我 们 实现 了 两 个 Android 设备 之 间 通 过 蓝牙 通信 的 实例 ， 重 点 在 于 蓝牙 
设备 的 开启 、 搜 索 以 及 通信 的 实现 。 实 际 的 通信 过 程 与 TCP 的 Socket 流程 类 似 ， 都 是 服 
务 器 端 BluetoothServerSocket 开启 等 待 客户 端的 接 入 ， 当 连接 建立 之 后 都 使 用 
BluetoothSocket 来 进行 通信 。 在 实例 的 实现 中 ， 还 有 一 个 UI 线程 和 数据 IO 线程 分 离 的 软 
件 设 计 思 想 ， 这 样 呈 现 给 用 户 的 UI 界面 和 软件 运行 核心 有 效 地 分 离 ， 在 UI 界面 中 不 会 出 
现 假 卡 死 的 现象 。 
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5.10 本 章 总结 


本 章 介绍 了 Android 支持 的 网 络 通信 方式 和 WiFi、 蓝 牙 设备 的 通信 管理 ， 通 过 实例 讲 
解 了 6 种 基本 网 络 编程 方式 : 基于 TCP/IP 的 Android 控制 PC、 基 于 UDP 的 Android 之 间 
聊天 、 基 于 HttpURLConnection 的 HITP 请 求 的 手机 号 码 归属 地 查询 、 基 于 HttpClient 的 
HTTP 请 求 的 天 气 预报 、 使 用 Web Service 的 远程 服务 的 在 线 翻译 、 基 于 WebView 视图 组 
件 的 简易 浏览 器 。 这 6 种 网 络 编程 方式 是 本 章 的 重点 也 是 难点 ， 在 实际 开发 中 是 必须 掌握 
的 技能 。 

本 章 对 Android 系统 支持 的 WiFi 和 蓝牙 设备 的 管理 与 通信 也 进行 了 详细 的 实例 讲解 ， 
是 掌握 了 以 上 6 种 基本 方式 后 的 扩展 。 











5.11 习 题 


【习题 1】 结合 5.2 节 和 5.3 节 的 TCP 和 UDP 通信 的 相关 内 容 , 实现 从 Android 客户 端 
上 传 本 地 文件 到 服务 器 端的 功能 。 


外 提示 : 使 用 TCP 和 UDP 的 通信 原理 ， 从 Android 客户 端 发 送 的 信息 是 本 地 的 文件 内 容 。 
TCP 客户 端 关键 代码 : 


Socket socket = new Socket ("127.0.0.1", 1234); 
// 使 用 InputStream 读 取 本 地 文件 
InputStream inputStream = new FileInputstream("D:\\aa.txt"); 
// 从 Socket 中 得 到 OutputStream 
OutputStream outputStream = socket.getOutputStream() 7 
byte[] buffer = new byte[4 * 1024]; 
int temp = 0; 
// 将 Inputstream 中 的 数据 取出 ， 并 写 入 到 outputstream 中 
while ((temp = inputStream.read(buffer)) != -1) 


# 
outputStream.write (buffer, 0, temp); 


} 
outputStream.flush (); 
outputstream.close(); 
socket .close (); 


UDP 客户 端 关键 代码 : 
DatagramSocket socket = new DatagramSocket(); 
// 创 建 一 个 InetAddress 
InetAddress serverAddress = InetAddress.getByName ("127.0.0.1"); 
InputStream inputStream = new FileInputSstream("D:\\aa.txt"); 
byte[] buffer = new byte[4 * 1024]; 
int temp = 0; 
// 将 InputStream 中 的 数据 取出 ， 并 写 入 到 OutputStream 中 
while ((temp = inputStream-read(buffer)) != -1) 
{ 
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// 创 建 一 个 DatagramPacket 对 象 ， 指定 其 发 送 地址 和 端口 号 
DatagramPacket packet = new DatagramPacket (buffer, temp, 
serverAddress, 1234); 


// 调 用 Socket 对 象 的 send () 方法 发 送 数据 
socket .send (packet); 
| 
【习题 2】 结 合 5.4 节 和 5.5 节 的 相关 内 容 ， 分 别 使 用 HttpURLConnection 方式 来 实现 
天 气 预报 的 功能 ， 使 用 HttpClient 方式 来 实现 手机 号 码 归 属地 的 查询 。 
名 提示 : 两 种 Http 访问 方式 类 似 ， 都 是 通过 URL 地 址 进行 访问 并 获取 返回 数据 。 找到 了 
正确 的 URL 地 址 即 可 按照 各 自 的 访问 步骤 进行 访问 。 
【习题 3】 结 合 5.6 节 的 相关 内 容 ， 使 用 Web Service 实现 火车 时 刻 表 的 查询 功能 。 
全 提示 : 在 5.6 节 的 Web 服务 器 网 站 中 也 提供 了 火车 时 刻 表 的 Web 服务 ， 使 用 该 Web 服 
务 来 实现 火车 时 刻 表 的 查询 。 


"As 


第 6 章 Android 多 媒体 


在 现代 手机 中 ， 娱 乐 方面 的 功能 越 来 越 多 ， 播 放 音乐 、 播 放 视频 、 拍 照 、 录 制 音 视频 
等 可 以 说 是 必 不 可 少 的 功能 。 在 Android 系统 中 也 是 提供 了 这 些 功能 来 满足 用 户 的 需求 。 
在 本 章 中 ， 我 们 将 围绕 这 些 多 媒体 技术 进行 实例 讲解 。 


6.1 音乐 播放 器 


在 Android 系统 中 , 使 用 的 底层 框架 库 提 供 了 对 大 部 分 图 像 和 音 视 频 编 码 格式 的 支持 ， 
主要 包括 MPEG4、H.264、MP3、AAC、AMR、JPG、PNG、GIF 等 格式 。 当 然 ， 要 完全 
支持 这 些 格式 还 需要 硬件 设备 的 支持 。 在 这 一 节 中 , 我 们 通过 实现 简易 的 MP3 播放 器 来 讲 
解 在 Android 系统 中 音频 播放 的 使 用 。 

在 本 实例 中 ， 我 们 实现 的 简易 MP3 播放 器 ， 首 先 搜索 SD 卡 中 所 有 MP3 文件 并 将 这 
些 文件 以 搜索 到 的 顺序 保存 为 播放 列表 ， 然 后 通过 ListView 来 显示 该 播放 列表 。 当 用 户 单 
击 ListView 中 的 某 一 项 时 ， 就 播放 该 项 对 应 的 音乐 。 当 然 ， 我 们 也 可 以 使 用 播放 、 和 暂停 、 
停止 、 上 一 首 、 下 一 首 来 调整 音乐 播放 的 情况 。 为 了 满足 这 些 功能 ， 界 面 设 计 如 图 6.1 
所 示 。 


ex_musicPlayer 





图 6.1 MP3 播放 器 
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6.1.1 播放 列表 


在 创建 播放 列表 时 ， 我 们 通过 对 SD 卡 中 全 部 文件 遍历 来 获取 所 有 的 MP3 文件 ， 然 后 
显示 该 播放 列表 。 


1. 遍历 SD 卡 
在 实现 过 程 中 , 我 们 先 判 断 遍历 到 的 File 是 否 为 文件 夹 , 如 果 不 是 文件 夹 则 判断 该 File 


的 后 缀 名 是 否 为 MP3， 当 是 MP3 时 添加 到 播放 列表 中 ;如 果 该 File 是 文件 夹 则 递归 调用 
该 方法 获取 下 一 层 目 录 中 的 MP3 文件。 具体 的 实现 如 下 : 


01 “// 志 历 路 径 下 指定 的 后 绥 名 


02 Private void search (String dir, final String suffix, List<String> 
list) { 
03 File file = new Filel(dir); 
04 // 遍 爵 该 目录 中 的 所 有 文件 
05 File[] files = file.listFiles(); 
06 if ((files != null) && (files.length > 0)) { 
07 for (File tmpfile : files) { 
08 // 如 果 是 文件 夹 ， 继 续 遍历 该 目录 
09 if (tmpfile.isDirectory()) { 
10 search (tmpfile.getPath(), suffix, list); 
LL } else { 
号 // 判 断 文件 后 绥 名 
be if (tmpfile.getPath() .endsWith(suffix)) { 
14 list.add (tmpfile.getPath()); 
// 如 果 为 指定 后 缀 名 ， 则 添加 到 列表 中 
15 } 
16 } 
1 } 
18 } 
9 } 
其 中 , 02 行 二 “ 烛 历 SD 卡 方法 。 参数 dir 是 当前 遍历 的 文件 夹 路 径 , 参数 suffix 是 需 
要 保存 文件 的 后 级 名 ， 参 数 list 是 保存 的 播放 列表 ; 


03 一 06 行 ， 获 取 当 前 文件 夹 下 的 所 有 File; 

07 一 11 行 ， 逐 个 判断 当前 文件 夹 下 的 所 有 File， 当 该 File 是 文件 夹 则 递归 调用 该 方法 
继续 遍历 下 一 层 目录 ; 

12 一 15 行 ， 当 File 是 文件 时 ， 判 断 该 File 是 否 是 MP3 文件 ， 如 果 是 则 保存 到 list 中 。 


2. 播放 列表 处 理 


对 播放 列表 我 们 使 用 ListView 来 进行 直观 的 显示 。 对 于 ListView 的 显示 , 我 们 已 经 ; 
行 了 多 次 的 使 用 ， 相 信 大 家 都 比较 熟悉 ， 可 以 分 为 3 步 来 实现 : 〈1) 定义 ListView 中 每 
一 个 Item 的 布局 (2) 构造 ListView 的 显示 数据 (3) 指定 数据 中 的 项 与 显示 Item 中 
的 视图 项 对 应 。 在 这 里 就 不 再 更 述 ListView 的 显示 实现 。 

当然 ， 我 们 还 需要 实现 单 击 列 表 视 图 中 某 一 项 时 播放 该 项 的 功能 。 对 此 ， 我 们 只 需要 
写 列表 项 单 击 事件 即 可 ， 有 具体 实现 如 下 : 

















由 








实战 Android 应 用 开发 








01 Q@Override 
02 Protected void onListItemClick (ListView 1, View v, int position, long 
id) { 


03 //TODO Auto-generated method stub 

04 m list item = position; // 获 取 单 击 的 项 号 

05 String path = m playlist.get (m list item); // 获 取 单 击 歌曲 的 地 址 
06 playMusic (Path) : // 调 用 播放 音乐 方法 
| 


其 中 ，02 行 ， 重 写 定义 的 列表 项 单 击 事件 。 参 数 position 是 单 击 的 项 位 置 ， 该 值 与 单 
击 项 在 播放 列表 中 的 值 是 一 致 的 ; 

03 一 05 行 ， 获 取 播放 列表 中 单 击 项 对 应 的 歌曲 全 路 径 ; 

06 行 ， 播 放 选择 的 音乐 。 

















6.1.2 音乐 播放 


在 多 媒体 播放 中 ，Android 系统 使 用 了 一 个 名 为 MediaPlayer 的 类 。 该 类 可 以 用 来 播放 
音频 、 视 频 和 流 媒体 ，MediaPlayer 包含 了 音频 (Audio) 和 视频 (Video) 的 播放 功能 。 接 
下 来 ， 我 们 详细 了 解 MediaPlayer 类 的 各 种 方法 及 使 用 。 


1. MediaPlayer 类 


多 媒体 播放 中 ， 在 播放 前 我 们 需要 获得 播放 的 文件 、 准 备 数据 ;播放 时 我 们 需要 控制 
播放 、 和 暂停 、 停 止 、 播 放 进 度 控制 、 播 放 音 量 控制 等 操作 ;播放 结束 后 我 们 需要 释放 资源 。 


(1) 播放 前 

口 数据 来 源 

void setDataSource (String path) 

void setDataSource (FileDescriptor fd, long offset, long length) 

void setDataSource (FileDescriptor fd) 

void setDataSource (Context context, Uri uri) 

这 些 方法 都 是 常用 的 设置 多 媒体 数据 来 源 的 方法 。 其 中 ， 参 数 path 为 文件 的 路 径 ; 参 
数 得 为 播放 的 FileDescriptor; 参数 uri 为 播放 数据 的 URI 地 址 。 

口 数据 准备 

void prepare() 

void prepareAsync() 

这 两 个 方法 分 别 用 于 准备 数据 同步 或 者 数据 异步 。 在 播放 数据 和 显示 设置 完成 后 ， 就 
需要 使 用 这 两 个 方法 中 的 一 个 。 对 于 本 地 已 保存 的 文件 一 般 使 用 同步 prepare0 方 法 ， 对 于 
流 媒体 一 般 使 用 prepareAsync() 方 法 。 

(2) 播放 时 

当 数 据 设置 并 准备 完成 后 ， 就 可 以 播放 音频 或 视频 。 在 播放 时 ， 主 要 分 为 状态 属性 获 
取 以 及 播放 控制 两 方面 ,包括 setAudioStreamType(int)、setLooping(boolean)、setVolume(float, 
float)、pause()、start()、stop()、seekTo(int) 等 。 

口 状态 获取 
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Int getVideoHeight () 
Int getVideoWidth() 


获得 视频 的 高 度 和 宽度 ; 

Int getCurrentPosition() 

返回 当前 的 播放 位 置 ， 以 毫秒 为 单位 的 int 类 型 值 ; 
Int getDuration() 

返回 文件 的 时 间 长 度 ， 以 毫秒 为 单位 的 int 类 型 值 ; 
Boolan isLooping() 

返回 是 否 进 行 循 环 播放 ; 

Boolean isPlaying() 

返回 是 否 正 在 播放 ; 

口 播放 控制 

void start() 


void stop() 
void pause () 


在 音 视频 播放 中 最 基本 的 播放 控制 ， 分 别 用 于 开始 播放 、 停 止 播 放 和 暂停 播放 
void seekTo (int msec) 

用 于 指定 播放 的 位 置 ， 参 数 msec 是 以 毫秒 为 单位 的 时 间 值 ; 

void setLooping (boolean looping) 

用 于 设置 是 否 进行 循环 播放 ， 

void setVolume (float leftVolume, float rightVolume) 

用 于 设置 音量 大 小 。 

(3) 播放 结束 

void release() 

当 不 再 进行 播放 时 ， 用 于 释放 MediaPlayer 对 象 资源 

void reset() 

用 于 重 置 MediaPlayer 对 象 。 

当然 ， 除 了 以 上 基本 的 方法 以 外 ， 还 有 一 些 其 他 比较 常用 的 监听 事件 处 理 : 


setonBufferingUpdateListener (MediaPlayer.OnBufferingUpdateListener 
listener) 


监听 事件 ， 用 于 网 络 流 媒 体 的 缓冲 监听 ; 


setOonCompletionListener (MediaPlayer.OnCompletionListener listener) 


监听 事件 ， 用 于 网 络 流 媒体 的 播放 结束 监听 ; 


setOnErrorListener (MediaPlayer.OnErrorListener listener) 
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监听 事件 ， 用 于 设置 错误 信息 监听 


setOnVideoSizeChangedListener (MediaPlayer.OnVideoSizeChangedListener 
listener) 


监听 事件 ， 用 于 视频 尺寸 监听 。 
MediaPlayer 类 在 控制 多 媒体 播放 时 , 存在 多 个 状态 和 多 种 方法 , 具有 自己 的 生命 周期 。 





对 于 一 个 MediaPlayer 类 对 象 ， 需 要 设置 数据 来 源 、 准 备 数 据 才 能 进行 播放 。 在 播放 过 程 


， 可 以 控制 其 处 于 播放 、 和 暂停 、 停 止 等 状态 ;在 不 需要 播放 时 可 以 释放 该 MediaPlayer 


类 对 象 。 其 生命 周期 以 及 状态 转换 的 详细 过 程 如 图 6.2 所 示 。 






O “""@ 






reset() 


setDataSource( 






prepareAsync() 





OnPreparedListsneronPrepared()| Prepare() 


PrepareAsync() 








Looping=—true && 
playback completes 





seek To()/pause() 


stop() 





Looping 一 false && 
onCompletion()invoked on 
OnCompletionListener lstart0 


(note:from beginning) 


图 6.2 MediaPlayer 生命 周期 


2. 播放 器 实现 
我 们 已 经 详细 了 解 了 Android 系统 中 多 媒体 播放 类 MediaPlayer 的 相关 知识 , 接 下 来 我 
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们 就 使 用 MediaPlayer 类 进行 简易 播放 器 的 具体 实现 。 在 播放 器 中 ， 我 们 需要 实现 播放 、 
和 暂停、 停止 、 上 一 首 、 下 一 首 来 控制 音乐 的 播放 以 及 推迟 应 用 时 的 MediaPlayer 类 的 资源 
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释放 。 在 界面 设计 中 ， 我 们 分 别 使 用 5 个 按钮 来 实现 这 些 功 能 。 
(1) 播放 





在 音乐 播放 功能 中 ， 从 MediaPlayer 类 的 生命 周期 图 6.2 中 可 以 看 出 , 我们 需要 进行 对 





哪 


置 、 设 置 播放 源 、 准 备 数据 ， 然 后 才能 播放 该 音乐 。 由 于 我 们 不 采用 循环 播放 ， 当 选中 的 
歌曲 播放 结束 后 ， 需 要 播放 下 一 首 歌曲 。 熟 悉 了 播放 音乐 的 过 程 ， 实 现代 码 如 下 


01 MediaPlayer m musicplayer; // 定 义 多 媒体 播放 类 

02 m musicplayer = new MediaPlayer() : // 实 例 化 多 媒体 播放 类 
03 // 播 放 音乐 

04 void playMusic(String path) { 

05 EE 

06 m musicplayer.reset(); // 重 置 播放 器 
07 m musicplayer.setDataSource (path); // 设 置 数据 源 
08 m musicplayer.prepare (); // 准 备 同步 
09 m musicplayer.start(); // 开 始 播放 
10 if (m Playlist.isEmpty() == true) { 

和 Toast .makeText (this,， "播放 列表 为 空 "，1000) .show(); 
9 return; 

3 } 

14 m msicplayer.setOonCompletionListener (new OnCompletionListener() { 
5 QOverride  ”// 当 前 音乐 播放 结束 后 的 处 理 方法 

16 public void onCompletion (MediaPlayer arg0) { 

六 //TODO Auto-generated method stub 

18 nextMusic() ; // 调 用 播放 下 一 首 方法 

19 

20 I 

2 } catch (Exception e) { 

22 e.printSstackTrace (); 

| } 

24 } 


其 中 ，01 一 02 行 ， 实 例 化 一 个 多 媒体 播放 类 MediaPlayer; 


06 一 09 行 ， 分 别 对 播放 类 MediaPlayer 进行 重 置 、 设 置 播放 数据 源 、 
放 。 该 过 程 必须 按照 这 样 的 顺序 进行 ， 否 则 会 出 现 异 常 导致 不 能 播放 音乐 





14 一 20 行 ， 当 前 音乐 播放 完成 后 处 理 。 
(2) 暂停 


数据 准备 以 及 播 


在 暂停 功能 中 ， 我 们 通过 判断 当前 是 否 在 播放 ， 如 果 在 播放 ， 对 其 暂停 播放 ， 当 处 于 


停止 状态 时 ， 继 续 播放 该 音乐 。 具 体 实现 如 下 


01 // 暂 停 

02 pause.setOnClickListener (new OnClickListener() { 

03 @Override 

04 public void onClick(View v) { 

05 if (m musicplayer.isPlaying()) {  // 判 断 当 前 是 否 在 播放 
06 m musicplayer.pause(); // 正 在 播放 ， 则 暂停 
07 } else { 

08 m musicplayer.start(); // 未 播放 ， 则 开始 播放 
09 » 

10 i 

上 


其 中 ，05 行 ， 判 断 是 否 正 在 播放 ; 
06 行 ， 当 正在 播放 音乐 时 ， 暂 停 该 音乐 播放 ; 
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08 行 ， 当 没有 播放 音乐 时 ， 使 用 start0 方 法 继续 播放 音乐 。 


(3) 停止 











停止 功能 即 是 停止 播放 音乐 ， 并 且 在 下 一 次 播放 时 ， 不 再 从 停止 的 位 置 继续 播放 而 是 
从 头 开始 播放 音乐 。 具 体 实现 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 


// 停 止 
this.stop.setOonClickListener (new OnClickListener() { 
QOverride 
public void onClick(View v) { 
if (m musicplayer !=null) { // 判 断 多 媒体 播放 类 是 否 存在 
m musicplayer.stop(); // 停 止 播放 
} 
h 
1D); 


其 中 ，05 行 判 断 播 放 的 类 是 否 存 在 ; 


06 行 , 当 


播放 类 存在 时 , 无 论 当 前 处 于 播放 、 暂 停 、 停 止 的 何 种 状态 都 进入 停止 状态 。 


(4) 上 /下 一 首 
le 中 ， 其 仅仅 针对 单个 多 媒体 文件 或 者 文件 流 进行 播放 控制 ， 是 不 存在 


上 一 首 、 


- 首 这 样 的 切换 的 。 在 实现 该 音乐 播放 器 时 ， 我 们 保存 了 需要 播放 列表 ， 通 过 


at 上 一 首 、 下 一 首 这 样 的 功能 。 
在 上 /下 首 切换 时 ， 2 前 播放 的 列表 项 数字 进行 减 加 ,特别 是 对 于 列表 开始 项 和 






结束 项 需要 特别 注意 。 当 进行 下 一 首 切 换 时 ， 如 果 当 前 为 播放 列表 最 后 一 项 ， 则 需要 将 列 
表 项 值 置 为 0， 当 进行 上 一 首 切换 时 ， 如 果 当 前 为 播放 列表 第 一 项 ， 则 需要 将 列表 项 置 为 
列表 的 最 后 一 项 。 
注意 了 这 一 点 ， 具 体 的 实现 如 下 : 
01 A] 
02 next .setOnClickListener (new OnClickListener() { 
03 @Override 
04 public void onClick(View v) { 
05 if (m list item == (m playlist.size() - 1)) { 
// 判 断 当前 播放 是 否 为 列表 中 最 后 一 首 
06 m list item = 0; // 为 列表 中 最 后 一 首 ， 则 播放 第 一 首 
07 } else { 
08 m list itemt+; // 不 是 最 后 一 首 ， 则 播放 下 一 首 
09 } 
10 String path = m playlist.get(m list item); 
// 获 取 下 一 首 歌曲 地 址 
11 playMusic (path); // 调 用 歌曲 播放 方法 
了 } 
13 > 
14 
5 Pol=] 
16 last.setOnClickListener (new OnClickListener() { 
ky Q@Override 
18 public void onClick(View v) { 
19 if (m list item 一 0) { // 判 断 当 前 播放 是 否 为 列表 中 第 一 首 
20 严 - st item = m \ playlist.size() - 1; 
// 为 第 一 首 ， 则 播放 列表 中 最 后 一 首 歌 曲 
21 } else { 
22 m list item-—; // 不 是 第 一 首 ， 则 播放 上 一 首 
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23 1 
24 String path = m playlist.get(m list item); 

// 获 取 上 一 首 歌曲 地 址 
25 playMusic (Path) // 调 用 歌曲 播放 方法 
26 上 
本 DD); 


其 中 ，01 一 13 行 ， 进 行 播放 下 一 首 歌 曲 处 理 ; 

05 一 09 行 ， 如 果 当 前 播放 音乐 为 播放 列表 最 后 一 项 时 ， 设 置 下 一 首 为 列表 中 第 一 项 ; 
否则 设置 为 下 一 项 ; 

10~11 行 ， 从 播放 列表 中 获取 播放 音乐 的 路 径 ， 并 使 用 我 们 实现 的 播放 音乐 的 方法 进 
行 播放 ; 

15 一 27 行 ， 进 行 播放 上 一 首 歌曲 的 处 理 。 处 理 过 程 和 播放 下 一 首 的 处 理 类 似 ， 只 是 判 
断 的 是 当前 播放 项 是 否 为 播放 列表 中 的 第 一 项 。 

(5) 释放 资源 

当 用 户 退 出 应 用 程序 时 ， 我 们 需要 停止 正在 播放 的 音乐 并 释放 资源 结束 当前 活动 。 在 
这 里 ， 我 们 通过 监听 用 户 单 击 回 退 键 ， 来 判断 用 户 需 要 退出 音乐 播放 器 应 用 。 具 体 实现 
如 下 : 


01 Override 





02 public boolean onKeyDown (int keyCode, KeyEvent event) { 

03 if (keyCode == KeyEvent.KEYCODE BACK) {// 判 断 按键 是 否 为 回 退 键 
04 m musicplayer.stop(); // 停 止 播放 

05 m musicplayer.release(); // 释 放 资 源 

06 this.finish () ;// 结 束 当 前 界面 

07 return true; 

08 } 

09 return super.onKeyDown (keyCode, event); 

10 } 


其 中 ，03 行 ， 判 断 按 键 是 否 是 回 退 键 ; 
04 一 05 行 ， 释 放 播放 音乐 占用 的 资源 。 


6.1.3 运行 分 析 总 结 


通过 上 述 步 又， 我们 实现 了 简易 的 MP3 音乐 播放 器 ， 可 以 正常 地 播放 MP3 音乐 并 可 
以 满足 基本 的 操作 控制 。 

通过 实现 该 简易 的 MP3 音乐 播放 器 ， 我 们 熟悉 了 在 Android 系统 中 用 于 播放 音频 、 视 
频 、 流 媒体 的 类 MediaPlayer 的 生命 周期 以 及 其 播放 控制 的 使 用 。 在 Android 系统 中 ， 只 要 
能 够 支持 播放 的 多 媒体 编码 格式 ， 都 可 以 使 用 该 类 来 完成 对 该 多 媒体 的 播放 。 大 家 对 使 用 
MediaPlayer 类 来 对 多 媒体 进行 播放 处 理 的 方法 需要 熟练 掌握 。 


6.2 学 话机 器 人 
在 上 一 节 中 , 我 们 实现 了 一 个 MP3 的 音频 播放 器 ， 了 解 掌握 了 在 Android 系统 中 多 媒 


体 文件 播放 的 实现 。 当 然 ，Android 提供 了 对 多 媒体 的 播放 ， 自 然 会 提供 对 多 媒体 的 采样 


ss 
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录制 的 功能 。 在 这 一 节 中 ， 我 们 通过 实现 一 个 学 话机 器 人 来 详细 讲解 在 Android 中 音频 的 
录制 方法 。 

本 实例 中 完成 的 学 话机 器 人 ， 是 一 个 通过 实时 录制 用 户 所 说 的 话 并 及 时 播放 该 音频 ， 
来 达到 重复 用 户 所 说 的 话 的 效果 的 机 器 人 。 我 们 需要 实现 录制 音频 并 且 在 录制 完成 后 播放 
该 音频 的 功能 ， 对 于 界面 设计 ， 只 需要 一 个 控制 录制 的 按钮 和 一 个 可 爱 的 机 器 人 图 片 ， 实 
现 效 果 如 图 6.3 所 示 。 








Ex recording 


开始 学 习 说 话 





6.2.1 语音 录制 


在 进行 多 媒体 播放 时 ， 我 们 知道 使 用 MediaPlayer 类 来 进行 处 理 ， 而 对 于 多 媒体 的 采 
样 录制 ， 在 Android 中 使 用 了 MediaRecorder 类 来 进行 处 理 。 和 多 媒体 播放 类 MediaPlayer 
类 似 ，MediaRecorder 类 可 以 用 来 录制 音频 和 视频 。 只 是 当 录 制 时 ，Android 系统 默认 的 支 
竺 格式 比 播放 的 格式 更 少 ， 主 要 支持 的 编码 方式 有 AMR、AAC、H263、H264、JPG 等 。 
接 下 来 ， 我 们 详细 讲解 多 媒体 录制 类 MediaRecorder 的 方法 以 及 其 使 用 。 


1. MediaRecorder 类 


对 于 多 媒体 的 录制 ， 在 录制 之 前 我 们 需要 设置 音 视 频 的 采样 来 源 、 录 制 的 编码 方法 、 
保存 文件 的 格式 、 保 存 文件 的 路 径 ; 完成 这 些 设 置 后 通知 准备 数据 ， 然 后 可 以 开始 进行 采 
样 录制 ， 当 录制 完成 后 停止 录制 并 释放 资源 。 在 MediaRecorder 类 中 提供 了 相应 的 方法 来 
处 理 这 些 操作 ， 常 用 的 方法 有 : 

(1) 录制 设置 
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口 采样 来 源 : 
void setAudioSource(int audio source) 


void setVideoSource (int video source) 
void setCamera (Camera c) 


这 3 个 方法 分 别 用 于 设置 音频 来 源 、 视 频 来 源 、 照 片 来 源 。 其 中 ， 音 频 来 源 的 参数 系 
统 中 已 经 定义 在 MediaRecorder.AudioSource 类 中 ， 有 CAMCORDER、DEFAULT、MIC、 
VOICE CALL、VOICE COMMUNICATION、VOICE DOWNLINK、VOICE RECOGNI- 
TION、VOICE UPLINK。 但 是 ， 这 些 不 同 的 音频 来 源 都 需要 在 硬件 上 特别 的 支持 。 在 实 
际 的 使 用 时 我 们 只 能 从 手机 麦克 风 中 获取 音频 信号 ， 所 以 音频 来 源 都 设置 为 
AudioSource.MIC 。 


口 编码 方式 : 
void setAudioEncoder (int audio encoder) 
void setVideoEncoder (int video encoder) 


这 两 个 方法 分 别 用 于 设置 音频 和 视频 的 编码 方式 。 其 中 ， 音 频 的 编码 方式 已 经 定义 在 
系统 MediaRecorder.AudioEncoder 类 中 ， 其 值 可 以 是 AAC、AMR_NB、AMR_WB。 其 中 ， 
最 常用 的 是 AudioEncoder.AMR_NB。 视 频 的 编码 方式 定义 在 MediaRecorder.VideoEncoder 
类 中 ， 其 值 为 H263、H264、MPEG 4_SP。 

口 保存 格式 : 

void setOutputFormat (int output format) 

该 方法 用 于 设置 保存 文件 的 格式 。 对 于 不 同 的 编码 方式 ， 保 存 的 文件 格式 也 不 一 样 。 
这 些 文件 格式 已 经 定义 在 MediaRecorder.OutputFormat 类 中 ， 其 值 为 RAW_AMR.、 
AMR NB、AMR_WB、MPEG 4、 THREE GPP. 

口 保存 路 径 : 


void setOutputFile (FileDescriptor fd) 
void setOutputFile (String path) 


这 两 种 方法 都 用 于 设置 录制 的 音 视频 的 保存 文件 。 

口 准备 数据 : 

void prepare () 

该 方法 用 于 通知 录制 已 经 准备 。 在 调用 该 方法 之 前 , 必须 完成 上 述 音 视频 的 采样 来 源 、 
录制 的 编码 方法 、 保 存 文件 的 格式 、 保 存 文件 的 路 径 等 的 设置 。 

(2) 录制 控制 

在 音 视频 录制 中 ， 不 再 需要 播放 时 那么 多 的 状态 变化 。 只 需要 开始 、 停 止 、 
放 操 作 ， 分 别 使 用 方法 : 


[ho 





EE 置 、 释 


void start () 
void stop() 
void reset () 
void release() 


使 用 上 述 的 方法 就 可 以 利用 MediaRecorder 类 来 进行 录制 音 视 频 操作 ， 该 类 的 生命 周 
以 及 状态 转换 如 图 6.4 所 示 。 

















"ls 


实战 Android 应 用 开发 














Error occurs or 
an invalid call 


SetAudioSource(O/ 
setVidioSource() 


etAudioSource()/ 
setVidioSource() 


reset()/ 
stop() setOutputFormat() 


EtA gio ncoder 
setVidioEncoder 
setOutputFile() 
setVideoSize() 
setVideoFrameRate() 
setPreviewDisplay() 





图 6.4 MediaRecorder 生命 周期 


2. 录制 实现 


学 话机 器 人 主要 分 为 音频 录制 和 音频 播放 两 部 分 。 通 过 上 述 的 讲解 ， 我 们 已 经 详细 了 
解 了 Android 系统 中 多 媒体 录制 类 MediaRecorder 的 相关 方法 和 生命 周期 。 接 下 来 我 们 就 
使 用 MediaPlayer 类 来 实现 学 话机 器 人 的 音频 录制 功能 。 

(1) 权限 申请 

当 实 现 音频 录制 时 ， 需 要 申请 音频 录制 的 权限 。 另 外 ， 我 们 将 录制 的 音频 文件 保存 在 
SD 卡 中 ， 也 需要 申请 权限 。 所 以 ， 在 AndroidManifestxml 文件 中 实现 如 下 : 

// 音 频 录制 权限 

<uses-permission android:name="android.permission.RECORD AUDIO"/> 

//SD 卡 写 权限 

ee 全 ne nnd -permission.WRITE EXTERNAL STORAGE"/> 

(2) 录制 实现 

在 进行 音频 录制 之 前 我 们 需要 针对 音频 的 采样 来 源 、 录 制 的 编码 方法 、 保 存 文件 的 格 
式 、 保 存 文件 的 路 径 进行 设置 ， 完 成 这 些 设置 后 才能 准备 数据 并 开始 录制 。 其 具体 实现 
如 下 : 


01 MediaRecorder mr; // 录 音 类 
02 private boolean mrstart() { 
03 //TODO Auto-generated method stub 
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04 mr = new MediaRecorder () // 实 例 化 多 媒体 录制 类 
05 mr.setAudioSource (AudioSource -MIC) 

06 // 设 置 音源 ， 这 里 是 来 自 麦 克 风 

07 mr .setOutpPutFormat (OutPutFormat .RAW AMR); 

08 // 输 出 格式 

09 mr .setAudioEncoder (MediaRecorder .AudioEncoder .AMR NB); 
10 // 编 码 方式 

hE mr.setOutputFile (filepath); 

1 // 输 出 文件 路 径 

13 EE 

14 mr .prepare(); 

5 // 做 些 准备 工作 

16 mr.start(); 

17 // 开 始 

18 return true; 

19 } catch (Exception e) { 

20 e.printStackTrace (); 

和 return false; 

之 芝 } 

23.00} 

其 中 ，01 一 04 行 ， 定 义 并 实例 化 了 一 个 多 媒体 采样 录取 类 MediaRecorder; 
05 行 ， 设 置 音频 的 来 源 ， 其 来 自 Android 手机 的 麦克 风 ; 

07 行 ， 设 置 保存 的 音频 的 文件 格式 ， 使 用 AMR 的 格式 ; 





09 行 ， 设 置 保存 的 音频 的 编码 方式 ， 使 用 AMR_NB 编码 方式 。 编 码 方式 需要 和 保存 
格式 相对 应 ; 

11 行 ， 设 置 保存 的 输出 文件 路 径 。 这 样 才能 获得 录制 的 音频 文件 。 需 要 
的 4 个 设置 顺序 可 以 任意 交换 ， 但 是 必须 在 调用 方法 prepareO 前 完成 这 些 设置 ， 

14 行 ， 调 用 prepare() 方 法 ， 通 知 录制 设置 完成 ， 准备 就 绪 ; 

16 行 ， 开 始 进行 音频 录制 ， 效 果 如 图 6.5 所 示 。 
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Ex recording 





得 的 是 上 述 








图 6.5 音频 录制 
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6.2.2 机 器 人 学 话 


当 学 话机 器 人 完成 了 学 话 后 ， 就 
的 录制 并 且 播 放 录 制 的 音频 。 


结束 音频 录制 


当 停 止 音频 录制 时 ， 只 需要 调用 stop0 方 法 即 可 。 具 体 实现 如 下 : 


01 // 停 止 录音 

02 private void mrstop() { 

03 //TODO Auto-generated method stub 
04 if (mr != null) { 

05 mr.stop(); // 停 止 
06 mr.release(); // 释 放 


由 





要 重复 刚才 学 到 的 话 ， 也 就 是 说 我 们 需要 结束 音频 


其 中 ，05 行 ， 停 止 音频 录制 ; 
06 行 ， 停 止 音频 录制 后 释放 资源 。 


2. 播放 录音 

当 1 来 了 录音 之 后 ， 需 要 播放 该 录音 文件 从 而 达到 学 话 的 目的 。 对 于 音频 播放 ， 我 们 
在 上 一 节 中 已 经 详细 讲解 ， 需 要 设置 音频 来 源 、 准 备 数据 ， 然 后 播放 音频 并 在 播放 完成 后 
进行 处 理 。 这 一 过 程 具体 的 实现 如 下 : 

01 “// 播 放 录音 

02 void vplay(String path) { 

03 Ey 

04 mplayer= new MediaPlayer(); // 实 例 化 多 媒体 播放 类 

05 mplayer .reset (); // 重 置 播放 类 

06 mplayer.setDataSource (Path) : // 设 置 数 据 源 

07 mplayer.Prepare (); // 准 备 同步 

08 mplayer.start (); // 开 始 播放 

09 // 播 放 完成 

10 mplayer.setOnCompletionListener (new OnCompletionListener() { 

11 @Override 

2 public void onCompletion (MediaPlayer arg0) { 

3 //TODO Auto-generated method stub 

14 mplayer .release (); // 播 放 完 毕 ， 释 放 资 源 

1 btn record.setText ("开始 学 习 说 话 ") ; // 修 改 按钮 显示 

16 is recording=false; // 修 改 录音 状态 标识 

2 

18 } 

19 Ps 

20 } catch (Exception e) { // 异 常 处 理 

之 二 System.out .println(e-toString()) 7 

人 2 if (mplayer!=null) { 

Je | mplayer-release(): // 释 放 资 源 

24 } 

2 btn record.setText ("开始 学 习 说 话 ") ; ”// 修 改 按 钮 显示 
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26 is recording=false; // 修 改 录音 状态 标识 

23 Toast.makeText (Ex recordingactivity-this，" 无 法 播放 "， 
1000) -show () ; E 

28 | 

芝 3 


其 中 ，04 一 08 行 ， 使 用 多 媒体 播放 类 MediaPlayer 来 播放 音频 ， 设 置 了 音频 文件 来 源 、 
准备 数据 以 及 开始 播放 ; 

10 一 19 行 ， 当 播放 结束 后 的 处 理 。 主 要 是 释放 资源 以 及 更 改 按 钮 显示 ， 其 效果 如 图 
6.6 所 示 。 





6.2.3 ”运行 分 析 总 结 


通过 上 述 步 又， 我 们 实现 了 一 个 学 话机 器 人 。 使 用 音 视 频 录制 类 MediaRecorder 来 进 
了 音频 采样 录取 并 保存 为 音频 文件 ， 然 后 使 用 音 视频 播放 类 MediaPlayer 来 播放 该 音频 文 





件 ， 达 到 了 重复 用 户 所 说 的 话 的 功能 ， 录 制 的 音频 文件 如 图 6.7 所 示 。 


mr 








SG sdcard 
1318936597201. jpg 119258 
MlNonber. txt 1406 
HG DCIN 
Justin Bieber-Baby. mp3 1735679 
由 CG LDST. DIR 
address, Xml 192 
sandroidRecording, anr 42598| 
司 daaex lre 1241 
dqcx, mp3 5453060 
悦 ex_file txt 70 
图 6.6 音频 播放 图 6.7 录音 文件 


在 本 节 中 ， 重 点 讲解 了 音 视 频 录制 类 MediaRecorder 的 方法 和 使 用 ， 需 要 特别 注意 的 
是 ， 在 录制 之 前 必须 完成 对 音 视频 的 采样 来 源 、 录 制 的 编码 方法 、 保 存 文件 的 格式 、 保 存 
文件 的 路 径 的 设置 ， 然 后 才能 进行 录制 。 


6.3 ”视频 播放 器 


在 前 面 章节 中 ， 我 们 详细 讲解 了 Android 中 音频 的 播放 和 录制 。 在 这 一 节 中 ， 我 们 将 
实现 一 个 视频 播放 器 来 对 Android 系统 中 的 视频 播放 进行 详细 讲解 。 
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在 视频 播放 器 中 ， 我 们 需要 实现 显示 视频 内 容 、 控 制 视频 播放 、 和 暂停 、 快 进 、 快 退 等 
功能 ， 界 面 设 计 如 图 6.8 所 示 。 


poi 


Ex VideoPlayer 





图 6.8 ”视频 播放 器 
对 于 视频 播放 ，Android 中 最 常 采用 两 种 方法 来 实现 : 一 种 是 使 用 多 媒体 播放 类 
MediaPlayer 来 实现 。 在 前 面 章节 中 ,我 们 已 经 详细 介绍 了 使 用 该 类 来 进行 音频 的 播放 ,在 
本 节 中 我 们 会 使 用 该 类 来 完成 视频 的 播放 ， 另 一 种 是 使 用 Android 内 置 的 VideoView 控件 
来 实现 ， 这 种 方法 可 以 更 加 快速 地 实现 视频 播放 器 。 接 下 来 ， 我 们 分 别 使 用 这 两 种 常用 方 
法 来 实现 一 个 视频 播放 器 。 


6.3.1 多 媒体 播放 类 


使 用 多 媒体 播放 类 MediaPlayer 类 来 进行 音频 播放 时 ， 我 们 不 需要 在 界面 上 设置 控件 
来 控制 音频 ， 而 对 于 视频 而 言 ， 最 大 的 区 别 便 是 我 们 需要 在 界面 上 显示 出 视频 的 图 像 。 


1. 图 像 显示 








使 用 MediaPlayer 类 进行 视频 播放 时 ， 显 示 视 频 图 像 使 用 SurfaceView 来 显示 ， 并 通过 
SurfaceHolder 来 对 显示 进行 控制 。 

(1) 界面 布局 

在 界面 布局 文件 中 ， 需 要 添加 SurfaceView 的 视图 。 该 SurfaceView 是 视图 (View) 
的 继承 类 ， 其 内 能 了 一 个 专门 用 于 绘制 的 Surface。 在 布局 XML 文件 中 ， 实 现 如 下 : 

<SurfaceView 


android:id="@+id/surfaceView" 
android:layout width="wrap content" 
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android:layout height="wrap content" /> 


(2) 视频 图 像 控制 

对 于 该 SurfaceView 的 控制 ， 可 以 使 用 SurfaceHolder 接口 来 完成 。 首 先 ， 需 要 获取 该 
SurfaceView 的 SurfaceHolder 接口 ， 使 用 方法 : 

SurfaceHolder getHolder() 

其 中 ， 返 回 值 便 是 控制 接口 SurfaceHolder 类 。 在 SurfaceHolder 类 中 ， 我 们 可 以 设置 
添加 回调 、 设 置 显示 的 固定 大 小 、 获 得 数据 来 源 等 ， 分 别 使 用 方法 : 


void addCallback (SurfaceHolder.Callback callback) 
void setFixedSize(int width, int height) 
void setType (int type) 


在 本 示例 中 ， 对 于 显示 视频 图 像 的 SurfaceView 的 设置 实现 如 下 : 














01 SurfaceHolder surfaceHolder; // 定 义 控制 接口 类 
02 MediaPlayer mediaPlayer; // 定 义 多 媒体 播放 类 
03 surfaceView = (SurfaceView) findViewById(R.id.surfaceView); 
// 绑 定 视图 
04 surfaceHolder = surfaceView.getHolder();  // 获 取 控制 接口 类 
05 surfaceHolder.addCallback (this) // 添 加 回调 方法 
06 surfaceHolder .setFixedSize (320, 240); // 设 置 视频 大 小 
07 surfaceHolder.setType (SurfaceHolder.SURFRCE TYPE PUSH BUFFERS) 
// 设 置 数据 源 类 型 


其 中 ，03 行 ， 获 取 界 面 设计 中 的 SurfaceView 视图 ; 

04 行 ， 获 取 SurfaceView 视图 的 控制 接口 SurfaceHolder; 

05 行 ， 添 加 SurfaceView 的 回调 实现 方法 。 由 于 在 类 中 实现 了 SurfaceHolder.Callbac 
接口 ， 所 以 参数 为 this; 

06 行 ， 设 置 视频 图 像 显示 的 固定 大 小 为 宽 320、 高 240; 

07 行 ， 设置 视频 图 像 的 数据 来 源 这 里 来 自 于 缓存 中 。 

(3) 接口 实现 

对 SurfaceView 的 变化 监控 ， 我 们 需要 实现 SurfaceHolder.Callback 接口 。 在 该 接口 中 
针对 SurfaceView 的 创建 、 销 毁 以 及 变化 时 ， 都 可 以 进行 相应 的 处 理 。 在 本 实例 中 ， 我 们 
需要 该 SurfaceView 成 功 创建 之 后 才能 加 载 播放 视频 ， 不 然 视频 没有 显示 该 视频 的 控件 。 
具体 实现 如 下 : 

01 public class Ex VideoPlayerActivity extends Activity implements 





SurfaceHolder.Callback { // 实 现 接口 
02 @Override 
03 Public void surfaceChanged (SurfaceHolder arg0, int argl, int arg2, 
int arg3) { 
04 // 当 视图 变化 时 调用 
05 } 
06 
07 @Override 
08 Public void surfaceCreated (SurfaceHolder holder) { 
09 // 当 视图 创建 时 调用 
10 PlayVideo (PathString) // 调 用 播放 视频 方法 
da } 
和 
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13 @Override 

14 Public void surfaceDestroyed (SurfaceHolder holder) { 
ls // 当 视图 销毁 时 调用 

16 } 

1 


其 中 ,01 行 ， 定义 视频 播放 类 ， 其 定义 了 需要 实现 SurfaceHolder.Callback 接口 。 在 该 
接口 中 ， 必 须 全 部 实现 SurfaceView 的 变化 、 创 建 以 及 销毁 时 的 处 理 ; 

03 一 05 行 ， 实 现 接口 中 SurfaceView 变化 时 的 处 理 ， 在 本 例 中 不 做 处 理 ; 

07 一 11 行 ， 实 现 接口 中 SurfaceView 创建 时 的 处 理 。 当 创建 完成 后 ， 我 们 立即 播放 
视频 ; 

13 一 16 行 ， 实 现 接口 中 SurfaceView 销毁 时 的 处 理 ， 在 本 例 中 不 做 处 理 。 


2. 视频 播放 控制 


对 于 多 媒体 播放 类 MediaPlayer, 我 们 在 音乐 播放 器 中 对 该 类 的 生命 周期 和 常用 方法 进 
行 了 详细 的 讲解 。 在 这 里 ， 我 们 将 对 使 用 MediaPlayer 类 进行 视频 播放 的 具体 实现 进行 
讲解 。 

(1) 视频 播放 

在 播放 视频 之 前 ， 不 仅 需要 设置 数据 来 源 ， 还 需要 设置 视频 图 像 的 显示 控件 。 然 后 ， 
再 进行 数据 的 准备 和 播放 。 本 实例 中 ， 有 具体 实现 如 下 : 


01 private void playVideo (String strPath) { 
02 if (mediaPlayer.isPlaying()) { // 判 断 是 否 正在 播放 
03 mediaPlayer.reset (); // 在 播放 则 重 置 播放 类 
04 
05 pe -setAudioStreamType (AudioManager .STREAM MUSIC); 
// 设 置 数据 源 类 型 
06 mediaPlayer.setDisplay(surfaceHolder) : 
// 设 置 Video 影片 以 SurfaceHolder 播放 
07 | 
08 mediaPlayer.setDataSource (strPath) : 
// 设 置 MediaPlayer 的 数据 源 
09 mediaPlayer .prepare(); // 准 备 播放 
10 } catch (Exception e) { 
zi e.printSstackTrace () 7 
pk } 
13 mediaPlayer.start (); // 开 始 播放 
14 1 


其 中 ，02 一 04 行 ， 判 断 当前 视频 是 否 正在 播放 ， 如 果 正 在 播放 中 则 重 置 播放 类 ; 

05 行 ， 设 置 视频 播放 时 的 音频 流 类 型 ; 

06 行 ， 设 置 视频 播放 的 图 像 显示 控件 。 该 项 是 在 音频 播放 中 没有 的 ， 需 要 特别 注意 ; 

07 一 13 行 ， 设 置 视频 播放 的 数据 源 、 准 备 播放 数据 ， 然 后 播放 视频 。 该 过 程 和 音频 播 
放 类 似 。 

(2) 播放 控制 

在 视频 播放 过 程 中 ， 我 们 需要 控制 视频 播放 的 开始 、 暂 停 的 状态 变化 ， 以 及 对 视频 的 
快 进 、 快 退 的 控制 。 在 实现 时 ， 我 们 使 用 3 个 按钮 来 分 别 实现 这 3 个 功能 。 

在 播放 过 程 中 ， 通 过 对 当前 视频 是 否 正在 播放 进行 判断 ， 如 果 正 在 播放 则 暂停 视频 播 
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放 ; 如 果 没 有 播放 则 继续 播放 视频 。 有 具体 实现 如 下 : 


btn play.setOnClickListener(new OnClickListener() { 
Q@Override 
public void onClick(View v) { 


if (mediaPlayer.isPlaying()) {// 判 断 视频 是 否 正在 播放 


mediaPlayer.pause(); // 暂 停 播 放 

btn play.setText ("播放 "); ”// 设 置 按钮 显示 内 容 
} else { 

mediaPlayer.start (); // 开 始 播放 


btn play.setText ("暂停 "); // 设 置 按钮 显示 内 容 
} 
HW 


其 中 ，04 行 ， 对 当前 视频 是 否 播放 的 判断 ; 

05 一 06 行 ， 如 果 视 频 正在 播放 ， 则 暂停 视频 播放 并 更 改 按 钮 显示 内 容 ; 

08 一 09 行 ， 如 果 视 频 停止 播放 ， 则 继续 播放 视频 并 更 改 按钮 显示 内 容 。 

在 快 进 、 快 退 功能 中 ， 通 过 对 当前 播放 时 间 进 行 一 个 固定 时 长 10s 的 增加 或 减少 ， 来 
达到 快 进 、 快 退 的 效果 ， 具 体 实现 如 下 : 


btn rewind.setOnClickListener (new OnClickListener() { 
@Override 
public void onClick(View v) { 
int rewind = mediaPlayer.getCurrentPosition() - 10000; 


// 当 前 播放 时 间 减 少 10s 
if (rewind > 0) 1 // 判 断 该 值 是 否 正确 
mediaPlayer.seekTo (rewind); // 视 频 后 退 10s 跳 转 


} 
} 
jn 


btn forward.setOnClickListener (new OnClickListener() { 
QOverride 
public void onClick(View v) { 
int forward = mediaPlayer.getCurrentPosition() + 10000; 


// 当 前 播放 时 间 增 加 10s 
if (forward < mediaPlayer.getDuration()) { 
// 判 断 该 值 是 否 正确 
mediaPlayer.seekTo (forward) ; ”// 视 频 前 进 10s 跳 转 


} 
国生 


其 中 ，04 行 ， 获 取 当 前 播放 时 间 并 减少 10s; 
05 一 06 行 ， 判 断 该 时 长 是 否 为 正 值 ， 如 果 时 长 正确 则 播放 该 时 间 点 ， 实 现 快 退 效果 ; 
11 一 19 行 ， 和 快 退 类 似 ， 实 现 快 进 的 效果 。 


3. 运行 总 结 


通过 以 上 步骤 实现 了 一 个 简易 的 视频 播放 器 ， 效 果 如 图 6.8 所 示 。 使 用 多 媒体 播放 类 
MediaPlayer 来 完成 视频 的 播放 和 控制 。 使 用 MediaPlayer 来 进行 视频 播放 控制 ， 与 进行 音 
频 的 播放 控制 类 似 ， 只 是 需要 对 视频 图 像 显示 的 SurfaceView 控件 进行 设置 。 
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6.3.2 视频 视图 VideoView 


在 视频 播放 中 ,除了 使 用 MediaPlayer 之 外 ，Android 还 提供 了 VideoView 控件 来 更 快 
速 地 实现 视频 播放 的 功能 。 


1. 界面 布局 


VideoView 是 Android 系统 中 提供 的 一 个 控件 ， 在 使 用 时 首先 需要 在 界面 布局 文件 中 
添加 该 控件 ， 实 现 如 下 : 
<VideoView 
android:id="@+id/videoview" 
android:layout width="wrap content" 


android:layout height="wrap Content" 
android:layout weight="1" /> 


2. VideoView 设 置 


在 VideoView 类 中 ， 提 供 了 视频 播放 设置 以 及 控制 的 所 有 方法 ， 其 中 常用 的 方法 有 : 
口 视频 源 设置 : 

void setVideoPath (String path) 

void setVideoURI (Uri uri) 

这 两 个 方法 用 于 设置 视频 源 ， 分 别 用 于 设置 视频 源 文件 路 径 和 地 址 ; 

口 播放 视频 信息 属性 : 

int getBufferPercentage() 


int getCurrentPosition() 
int getDuration () 


这 3 个 方法 分 别 用 于 获取 视频 播放 过 程 中 缓冲 的 百分比 、 当 前 播放 的 位 置 以 及 视频 文 
件 的 时 间 长 度 。 
口 播放 状态 信息 : 


boolean canPause() 
boolean canSeekBackward () 
boolean canSeekForward() 
void seekTo (int msec) 














前 3 个 方法 用 于 判断 当前 视频 播放 的 状态 ， 分 别 判断 是 否 可 以 暂停 、 是 否 可 以 回 退 、 
是 否 可 以 前 进 。 然 后 使 用 最 后 一 种 方法 来 实现 视频 播放 进度 的 改变 。 

口 播放 控制 器 : 

void setMediaController (MediaController controller) 

该 方法 用 于 设置 播放 时 的 控制 器 。 该 控制 器 controller 是 Android 系统 本 身 的 媒体 控制 
器 ， 实 现 了 控制 播放 开始 、 和 暂停、 快 退 、 快 进 等 功能 。 在 使 用 VideoView 时 ， 只 需要 调用 
系统 的 媒体 控制 器 即 可 控制 视频 播放 。 

口 播放 控制 ; 


void start () 
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void pause () 
void resume () 


这 3 种 方法 用 于 对 视频 播放 状态 的 改变 , 分 别 用 于 开始 播放 、 暂停 播放 以 及 重新 播放 。 
上 述 这 些 方法 和 MediaPlayer 类 提供 的 方法 类 似 ， 使 用 VideoView 控件 来 实现 视频 的 
播放 就 非常 容易 ， 实 现 如 下 : 





01 VideoView = (VideoView) findViewById (R.id.videoview) 
// 绑 定 视图 控件 
02 // 定 义 MediaController 对 象 
03 mediaController = new MediaController (this); 
04 // 把 MediaController 对 象 绑 定 到 VideoView 上 
05 mediaController.setAnchorView (videoView); 
06 // 设 置 VideoView 的 控制 器 为 mediaController 
07 VideoView.setMediaController (mediaController); 
08 videoView.requestFocus (); 
09 Ey 
10 VideoView.setVideoPath (pathString); // 设 置 视频 播放 源 
全 于 VideoView.start(); // 开 始 播放 视频 
re } catch (Exception e) { 
3 //TODO: handle exception 
14 System.out .println(e.toSstring()); 
15 } 


其 中 ，01 行 ， 获 取 界 面 中 的 视频 播放 控件 VideoView; 

03 一 05 行 ， 实 现 媒体 控制 器 并 将 该 控制 器 绑 定 到 视频 播放 VideoView 中 ， 用 于 控制 
VideoView 中 的 视频 播放 ; 

07 行 ， 设 置 VideoView 的 播放 控制 器 为 mediaController， 这 样 就 进行 了 相互 的 注册 
绑 定 ; 

09 一 15 行 ， 设 置 视 频 源 并 播放 该 视频 ， 其 效果 如 图 6.8 所 示 。 

3. 运行 总 结 


经 过 以 上 步 又， 我们 同样 实现 了 一 个 简易 的 视频 播放 器 ， 其 实现 的 效果 和 使 用 
MediaPlayer 实现 的 视频 播放 效果 是 一 致 的 。 而且, 使 用 VideoView 来 实现 视频 播放 ， 步 又 
更 简单 、 播 放 控制 更 方便 。 


6.3.3 视频 播放 总 结 


在 本 节 中 ， 我 们 使 用 Android 中 不 同 的 两 种 方式 实现 了 简易 的 视频 播放 器 。 一 个 是 通 
用 性 的 多 媒体 播放 类 MediaPlayer, 另 一 个 是 更 便捷 的 VideoView 类 。 它们 都 需要 首先 设置 
播放 视频 图 像 的 控件 ， 然 后 设置 播放 视频 源 才 开始 播放 视频 并 进行 播放 控制 。 

但 是 ， 使 用 这 两 种 方式 来 实现 的 播放 视频 都 存在 不 足 。 因 为 Android 平台 中 的 应 用 程 
序 都 是 运行 于 Java Dalvik 虚拟 机 中 ， 其 处 理 效率 无 法 与 C/C++ 相 比 ,目前 原生 平台 仅仅 支 
持 MP4 和 3GP 视频 的 解析 ， 而 且 由 于 视频 的 码 率 、 帧 数 太 高 ， 将 出 现 不 能 流畅 播放 甚至 
有 声音 无 图 像 的 现象 。 对 于 这 些 对 处 理 效 率 有 较 高 要 求 的 应 用 ,使 用 Java 来 实现 是 无 法 满 
足 要 求 的 。 在 当前 Android 中 ,常用 的 方法 是 使 用 Android 的 NDK 开发 ,通过 调用 C/C++ 
实现 的 库 来 满足 效率 的 要 求 。 对 于 NDK 的 使 用 ， 我 们 将 在 后 面 的 章节 中 详细 讲解 。 
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6.4 照相 机 


当前 的 手机 设备 在 人 硬件 上 都 是 支持 摄像 头 的 ， 拍 照 功 能 成 为 了 Android 手机 的 基本 功 
能 。 在 本 节 中 ， 我 们 将 实现 一 个 照相 机 来 对 Android 中 的 拍照 应 用 进行 详细 的 讲解 。 

在 Android 系统 中 主要 有 两 种 方式 来 实现 拍照 的 功能 , 一 种 是 调用 系统 本 身 的 照相 机 ， 
另 一 个 是 使 用 Camera 类 来 实现 自己 的 拍照 程序 。 接 下 来 ， 我 们 分 别 使 用 这 两 种 方法 来 实 
现 照 相机 的 功能 。 


6.4.1 系统 照相 机 


由 于 对 手机 娱乐 功能 方面 的 需要 ， 在 Android 系统 中 都 是 自 带 系 统 照相 机 程序 的 ， 直 
接 调 用 系统 的 照相 机 程序 是 最 便捷 实现 照相 机 功能 的 方式 。 


对 于 调用 系统 拍照 ， 在 界面 上 我 们 只 需要 一 个 跳 转 的 按钮 以 及 对 拍照 结果 的 图 片 显 
示 。 界 面 设计 如 图 6.9 所 示 。 


加 5152-2 





图 6.9 功能 选择 界面 


1. 权限 申请 


要 使 用 Android 设备 的 摄像 头 硬 件 , 需要 申请 照相 机 Camera 的 相关 权限 , 而 且 当 拍摄 
的 图 像 保存 到 SD 卡 中 也 是 需要 申请 权限 。 在 AndroidManifestxml 文件 中 实现 如 下 : 


// 照 相机 权限 
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<uses-permission 


android:name="android.permission.CAMERA"></uses-permission> 


//SD 卡 写 权限 


<uses-permission 


android:name="android.permission.WRITE EXTERNAL STORAGE"></uses-permiss 


ion> 


2. 跳 转 设置 


在 Android 系统 中 提供 了 MediaStore 这 个 类 来 管理 其 多 媒体 数据 库 ，Android 中 多 媒 


体 信 息 都 可 以 从 这 里 提取 。 


在 Activity 间 跳 转 时 ， 我 们 需要 传 入 Intent 的 动作 ， 对 于 系统 的 照相 机 动作 ， 已 经 在 
系统 中 进行 了 定义 ,定义 为 MediaStore.ACTION IMAGE _ CAPTURE, 其 值 为 android.media. 


action.IMAGE CAPTURE. 


在 跳 转 到 系统 拍照 程序 时 ， 我 们 可 以 指定 拍照 的 图 片 输出 到 的 文件 地 址 ， 使 用 
MediaStore.EXTRA_OUTPUT 进行 设置 。 

对 于 拍摄 照片 的 像素 质量 , 可 以 使 用 MediaStore EXTRA_VIDEO_QUALITY 来 进行 设 
置 。 其 中 ，0 值 表示 低 质 量 ，1 值 表示 高 质量 。 

在 本 例 中 ， 我 们 为 了 方便 拍照 完成 后 显示 改 图 片 ， 指 定 拍照 保存 地 址 ， 实 现 如 下 : 


01 OnClickListener listener = new OnClickListener() { 


02 

03 @Override 

04 public void onClick(View v) { 

05 //TODO Auto-generated method stub 

06 switch (v.getId()) { 

07 case R.id.sys camera: 

08 // 调 用 系统 拍照 功能 

09 Intent imageCaptureIntent = new Intent (MediaStore. 
ACTION IMAGE CAPTURE); 

10 File out = new File(strImgPath);  ”// 设 置 保存 图 片 文件 

| Uri uri = Uri.fromFile (out); // 转 换 为 URI 地 址 

12 imageCaptureIntent .putExtra (MediaStore .EXTRA OUTPUT, 
Ura) // 设 置 图 片 保存 

13 imageCaptureIntent .putExtra (MediaStore .EXTRA VIDEO 
QUALITY, 1); // 图 片 质量 

14 startActivityForResult (imageCaptureIntent, RESULT_ 
CAMERA) ; // 有 返回 数据 跳 转 

5 break; 

16 

Ey } 

I 


其 中 ，01 一 04 行 ， 定 义 了 系统 拍照 按钮 的 单 击 处 理事 件 ; 

07 一 13 行 ， 对 于 跳 转 Intent 的 设置 。 其 中 ， 动 作为 系统 拍照 应 用 ， 指 定 了 成 功 拍照 后 
图 片 文件 的 保存 地 址 以 及 拍照 图 像 的 质量 ; 

14 行 ， 进 行 跳 转 。 这 里 使 用 了 带 数据 返回 的 跳 转 方式 ， 便 于 拍照 成 功 后 的 图 像 显示 。 


3. 拍照 返回 处 理 























当 调 用 系统 拍照 程序 成 功 拍照 后 ,我 们 需要 将 拍摄 的 图 片 显 示 在 界面 的 ImageView 中 。 
在 跳 转 返回 时 ， 我 们 从 图 像 缓存 中 获取 该 图 片 的 数据 进行 显示 ， 并 将 该 图 片 保存 到 SD 卡 
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中 。 具 体 实现 如 下 : 


01 Q@Override 


02 Protected void onActivityResult(int requestCode, int resultCode, 
Intent data) { 
03 //TODO Auto-generated method stub 
04 super.onActivityResult (requestCode, resultCode, data); 
05 
06 if (requestCode 一 RESULT CAMERA) { // 判 断 请 求 标识 
07 if (resultCode 一 RESULT OK) { // 判 断 返 回 结果 
08 // 拍 照 图 像 显 示 
09 Bitmap bm = (Bitmap) data.getExtras () .get("data") 
// 获 取 图 像 数据 
10 image. setImageBitmap (bm) ;  // 图 像 显 示 在 ImageView 视图 中 
11 File myCaptureFile = new File(strImgPath); 
// 设 置 保存 图 片 
12 Er 
13 BufferedoutputStream bos = new BufferedOoutputStream( 
14 new FileOutputStream(myCaptureFile)); 
// 初 始 化 数据 流 
1 // 采 用 压缩 转 档 方法 
16 bm.compress (Bitmap .CompressFormat.JPEG，80，bos) : 
eh // 调 用 flush () 方 法 ， 更 新 Bufferstream 
18 bos.flush(); 
19 // 结 束 OutputStream 
20 bos.close() 
wl } catch (FileNotFoundException e) { 
Z2 //TODO Auto-generated catch block 
23 e.printSstackTrace (); 
24 Toast .makeText (this，" 没 有 找到 照片 文件 "，1000) .show () ; 
25 } catch (IOException e) { 
26 //TODO Auto-generated catch block 
Ph e.printSstackTrace (); 
28 Toast .makeText (this, e.toSstring(), 1000).show(); 
2 } 
30 } 
3 } 


其 中 ，02 行 ， 重 写 跳 转 返回 方法 ; 
06 一 07 行 ， 判 断 跳 转 返回 来 源 和 返回 结果 标识 。 当 是 成 功 拍照 时 ， 进 行 显示 和 保存 


处 理 ; 
08 一 10 行 ， 从 返回 














跳 转 意图 Intent 中 获取 图 片 数 据 缓 存 ， 并 显示 在 ImageView 中 ; 


11 一 29 行 ， 将 图 片 数据 缓存 保存 为 SD 卡 中 的 图 片 文件 。 


4. 运行 分 析 


通过 以 上 步 又， 我 们 已 经 实现 了 调用 系统 照相 机 进行 拍照 并 显示 的 功能 。 由 于 模拟 器 
对 摄像 头 这 样 的 硬件 设备 不 能 进行 模拟 ， 所 以 对 于 拍照 相关 的 程序 ， 在 模拟 器 中 是 无 法 正 
常 运行 的 ， 照 相 程序 需要 在 真 机 中 进行 测试 。 

如 果 在 模拟 器 中 进行 测试 ， 该 代码 仅仅 能 够 成 功 地 跳 转 到 系统 照相 机 程序 ， 如 图 6.10 
所 示 。 但 是 ， 跳 转 到 该 系统 照相 机 程序 后 ， 其 拍照 功能 是 不 能 使 用 的 。 经 过 一 段 时 间 后 ， 
会 出 现 照相 机 程序 异常 的 提示 ， 如 图 6.11 所 示 。 
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全 Sorry! 


The application Camera 


(process com.android.camera) 
has stopped unexpectedly. 
Please try again. 


Force close 





图 6.10 





6.4.2 简易 相机 


除了 使 用 系统 自身 的 照相 机 之 外 , Android 系统 也 提供 了 Camera 类 来 方便 地 实现 拍照 
程序 。 接 下 来 ， 我 们 就 详细 讲解 使 用 Camera 类 来 实现 照相 机 的 功能 。 

我 们 在 已 经 完成 的 调用 系统 照相 机 的 基础 上 ， 添 加 调用 自 定 义 照 相机 的 按钮 进行 功能 
选择 ， 界 面 实现 如 图 6.12 所 示 。 





图 6.12 添加 自 定义 拍照 
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接 下 来 ， 我 们 来 具体 实现 自 定义 拍照 的 功能 ， 需 要 进行 如 下 几 步 操作 : 
1. 权限 申请 


在 调用 系统 拍照 程序 时 ， 我 们 申请 了 照相 机 Camera 的 相关 权限 ， 而 且 把 拍摄 的 图 像 
保存 到 SD 卡 中 也 是 需要 申请 对 应 的 权限 。 在 这 里 ， 我 们 实现 拍照 程序 还 需要 添加 照相 设 
备 的 硬件 支持 ， 在 AndroidManifest.xml 文件 中 实现 如 下 : 


<uses-permission 
android:name="android.permission.CAMERA"></uses-permission> 
<uses-permission 
android:name="android.permission.WRITE EXTERNAL STORAGE"></uses-permiss 
ion> 

<uses-feature android:name="android.hardware.camera" /> 

<uses-feature android:name="android.hardware.camera.autofocus" /> 


2. 图 像 初始 化 


在 实现 照相 机 功能 时 ， 我 们 需要 在 界面 中 不 断 刷 新 从 摄像 头 中 获取 的 图 像 ， 当 获取 的 
图 像 满足 用 户 的 需要 时 才 对 该 图 像 进行 保存 。 为 了 满足 不 断 刷 新 的 图 片 显示 的 要 求 ， 我 们 
使 用 SurfaceView 控件 。 在 界面 布局 中 , 我 们 只 需要 该 控件 即 可 。 对 于 SurfaceView 的 使 用 ， 
我 们 在 视频 播放 时 进行 了 详细 讲解 ， 这 里 就 不 再 歼 述 ， 具 体 实现 如 下 : 


01 public class Self camera extends Activity implements SurfaceHolder. 














Callback { // 实 现 回 调 接口 
02 // 拍 照 预 览 
03 Private SurfaceView surfaceView; // 定 义 视图 控件 
04 private SurfaceHolder surfaceHolder = null; // 定 义 控制 控件 
05 // 照 相机 
06 Private Camera mCamera = null; 
07 //Bitmap 对 象 ， 保 存 拍照 图 片 
08 Private Bitmap mBitmap = null; 
09 // 图 片 地 址 
10 Private String pathString; 
了 
2 //Rctivity 的 创建 方法 
13 GOverride 
14 Public void onCreate (Bundle savedInstanceState) { 
9 super.onCreate (savedInstanceState); 
16 // 设 置 布局 
17 setContentView(R.layout.selfcamera); 
18 // 绑 定 视图 
19 surfaceView = (SurfaceView) findViewById(R.id.preview); 
20 // 从 SurfaceView 中 获得 SurfaceHolder 
号 surfaceHolder = surfaceView.getHolder() : 
22 // 为 SurfaceHolder 添加 回调 
23 surfaceHolder .addCallback (this); 
24 surfaceHolder .setType (SurfaceHolder .SURFACE TYPE PUSH BUFFERS); 
25 | 


其 中 ，01 行 ， 定 义 了 拍照 程序 类 Self camera， 实 现 了 SurfaceHolder.Callback 接口 ; 

02 一 10 行 ， 定 义 了 在 该 类 中 的 全 局 变量 ; 

12 一 14 行 ， 定 义 了 Activity 的 创建 方法 。 在 该 方法 中 ， 我 们 主要 实现 对 SurfaceView 
的 处 理 ; 
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17 一 24 行 ， 实 现 了 整体 的 布局 、SurfaceView 控件 的 绑 定 、 添 加 了 回调 函数 以 及 获取 
的 显示 数据 的 来 源 。 


3. Camera 类 的 使 用 


Android 系统 提供 了 Camera 类 来 实现 拍照 相关 的 处 理 。 对 于 获取 摄像 头 设 备 信息 ， 我 
们 可 以 使 用 该 类 中 的 方法 : 


static void getCameraInfo (int cameraId，Camera.CameraInfo cameraInfo) 


其 中 ， 参 数 camerald 是 摄像 头 编号 ， 参 数 cameraInfo 是 摄像 头 信息 类 。 
当 拍 照 时 ， 需 要 开启 摄像 头 设备 并 获取 该 Camera 类 对 象 ， 使 用 方法 : 


static Camera open (int cameraId) 
static Camera open() 


其 中 ， 其 中 ， 参 数 camerald 是 选择 的 摄像 头 编号 。 该 方法 针对 有 多 个 摄像 头 的 手机 设 
备 使 用 ， 一 般 情况 都 使 用 不 带 参 数 的 方法 。 
开启 摄像 设备 后 ， 需 要 预览 摄像 头 中 获取 的 图 像 ， 使 用 方法 : 


final void startPreview() 
final void stopPreview() 


其 中 ， 第 一 个 方法 用 于 开始 预览 图 像 ， 第 二 个 方法 用 于 关闭 预览 。 
当 开 始 预 览 之 后 ， 我 们 需要 对 预览 的 图 像 进行 设置 ， 常 用 的 设置 方法 如 下 : 


final void setPreviewCallbackWithBuffer (Camera.PreviewCallback cb) 
final void setPreviewDisplay(SurfaceHolder holder) 
final void setPreviewTexture (SurfaceTexture surfaceTexture) 


其 中 ， 第 一 个 方法 设置 对 于 每 一 帧 的 图 像 缓 存 数据 的 处 理 ， 该 处 理 不 包括 显示 在 界面 
上 的 处 理 ; 

第 二 个 方法 设置 图 像 显 示 处 理 ， 参 数 holder 为 显示 的 SurfaceView 的 控制 接口 ; 

第 三 个 方法 设置 图 像 显示 ， 使 用 OpenGL ES 的 Texture 来 进行 显示 。 在 对 图 像 进 行 复 
杂 处 理 时 ， 我 们 需要 使 用 该 方法 。 

对 于 相机 的 预览 大 小 、 自 动 对 焦 、 保 存 图 片 的 分 辩 率 、 保 存 图 片 的 格式 等 参数 ， 设 置 
和 获取 时 使 用 以 下 的 方法 : 


void setParameters (Camera.Parameters params) 
Camera.Parameters getParameters() 


其 中 ， 第 一 个 方法 用 于 设置 相机 参数 ， 第 二 个 方法 用 于 获取 相机 的 设置 参数 。 
当 使 用 完 拍照 功能 后 ， 释 放 相机 的 资源 ， 使 用 方法 : 


final void release() 


在 Camera 类 中 ， 常 用 的 方法 便 是 这 些 方法 。 在 照相 过 程 中 ， 我 们 需要 开启 相机 、 设 

置 预览 、 设 置 相机 参数 、 启 动 预览 、 停 止 预览 、 释 放 资 源 这 样 一 个 流程 。 

在 本 例 中 ， 使 用 oeWiew 束 显示 预览 ， 其 实现 了 SurfaceHolder.Callback 接口 。 在 
视图 创建 时 ， 我 们 需要 启动 相机 并 进行 设置 ， 当 视图 销毁 时 ， 需 要 停止 预览 并 释放 相机 资 
源 。 对 于 SurfaceView 创建 和 销毁 时 的 具体 实现 如 下 : 
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01 QOverride  ”// 视 图 创建 时 调用 


02 Public void surfaceCreated (SurfaceHolder holder) { 
03 // 当 预览 视图 创建 的 时 候 开启 相 机 

04 mCamera = Camera.open(); 

05 Ey 寺 

06 // 设 置 预览 

07 mCamera.setPreviewDisplay (holder); 
08 } catch (IOException e) { 

09 // 释 放 相机 资源 并 置 空 

10 ImCamera.release() : 

让 二 mCamera = null; 

2 下 

JS 

14 } 

15 Q@Override 

16 public void surfaceDestroyed(SurfaceHolder holder) { 
on // 停 止 预览 

18 mCamera.stopPreview(); 

19 // 释 放 相机 资源 并 置 空 

20 ImCamera.release() 

21 mCamera = null; 

2 } 


其 中 ，01 一 02 行 ， 重 写 SurfaceView 视图 创建 完成 时 的 方法 ， 在 该 方法 中 实现 开启 相 
机 和 设置 预览 的 功能 ; 

04 行 ， 开 启 相 机 并 获取 相机 处 理 类 Camera; 

07 行 ， 设 置 预览 的 图 像 显示 控件 ， 本 例 中 显示 在 SurfaceView 中 ， 

08 一 11 行 ， 如 果 出 现 异 常 则 释放 相机 资源 并 置 空 ; 

15 一 16 行 ， 重 写 SurfaceView 视图 销毁 时 的 方法 ， 在 该 方法 中 实现 停止 预览 和 释放 相 
机 资源 并 置 空 的 功能 ; 

18 行 ， 停 止 相机 的 图 像 预览 

20 一 21 行 ， 释 放 相 机 资源 并 将 该 Camera 类 置 空 。 

4. 相机 参数 设置 

在 前 面 ， 我 们 重点 对 相机 的 预览 图 像 进行 了 设置 ， 在 这 里 我 们 对 相机 的 相关 参数 进行 
设置 。 在 相机 设置 中 ， 使 用 Camera.Parameters 类 来 提供 了 一 些 接口 设置 Camera 的 属性 ， 
常用 的 方法 有 : 

void setPictureFormat (int pixel format) 

该 方法 用 于 设置 图 片 的 格式 ， 其 取 值 为 PixelFormat.YCbCr 420_SP、PixelFormat. 
RGB 565 或 PixelFormat.JPEG。 

void setPreviewFormat (int pixel format) 

设置 图 片 预览 的 格式 ， 取 值 同 上 。 

void setPictureSize (int width, int height) 

设置 图 片 的 高 度 和 宽度 ， 单 位 为 像素 。 


void setPreviewSize (int width, int height) 
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设置 图 片 预览 的 高 度 和 宽度 ， 取 值 同上 。 


void setPreviewFrameRate (int fps) 
设置 图 片 预览 的 帧 速 。 
void setFocusMode (String value) 


设置 相机 的 对 焦 模 式 ， 其 值 一 般 是 FOCUS MODE AUTO 或 者 FOCUS MODE_ 
MACRO。 

掌握 了 相机 参数 设置 中 的 常用 方法 后 ， 我 们 来 设置 相机 参数 。 在 本 实例 中 ， 相 机 设置 
为 自动 对 焦 。 为 了 保证 该 设置 ， 在 SurfaceView 每 次 发 生 改 变 时 ， 就 进行 一 个 相机 设置 ， 
具体 实现 如 下 : 

01 // 当 surface 视图 数据 发 生变 化 时 ， 处 理 预览 信息 


02 @Override 

03 Public void surfaceChanged (SurfaceHolder holder, int format, int width, 

04 int height) { 

05 

06 // 获 得 相机 参数 对 象 

07 Camera.Parameters Parameters = mCamera.getParameters(); 

08 // 设 置 格式 

09 Parameters .setPictureFormat (PixelFormat .JPEG); 

10 // 设 置 预览 大 小 ， 根 据 显 示 大 小 设置 

4 //parameters.setPreviewSize(854, 480); 

12 // 设 置 自动 对 焦 

13 Parameters.setFocusMode ("auto"); 

14 // 设 置 图 片 保 存 时 的 分 辩 率 大 小 

15 //parameters.setPictureSize(2592, 1456); 

16 // 给 相机 对 象 设置 刚才 设 定 的 参数 

ply mCamera.setParameters (parameters); 

18 // 开 始 预览 

19 mCamera.startPreview(); 

20 } 

其 中 ，02 一 04 行 ， 重 写 SurfaceView 视图 改变 方法 ， 在 该 方法 中 实现 相机 的 设置 和 开 
DA 
台 预 览 ; 


07 行 ， 获 取 相 机 的 参数 对 象 ， 以 便 修 改 相机 参数 ; 

09 行 ， 设 置 图 片 格式 ， 这 里 设置 为 JPEG 编码 格式 ; 

11 行 ， 设置 预览 的 大 小 ， 该 大 小 与 显示 的 大 小 有 关 ， 如 果 设 置 过 大 会 发 生 异 常 ， 过 小 
则 会 在 界面 显示 不 友好 ， 建 议 在 不 知道 屏幕 显示 的 情况 下 不 做 设置 ; 








15 行 ， 设 置 图 片 保存 时 的 分 状 率 大 小 ; 
17 行 ， 将 修改 后 的 相机 设置 保存 到 拍照 Camera 中 ; 
19 行 ， 开 启 拍照 预览 。 在 模拟 器 中 ， 由 于 没有 硬件 设备 ， 其 效果 如 图 6.13 所 示 。 


5. 保存 拍照 图 片 


在 拍照 类 Camera 中 ， 不 仅仅 提供 了 拍照 时 常 使 用 的 方法 ， 也 提供 了 针对 相机 状态 的 
控制 接口 ， 分 别 是 : 
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图 6.13 拍照 预览 

Interface android.hardware.Camera.AutoFocusCallback 

当 摄像 头 自动 对 焦 的 时 候 调 用 ， 该 接口 具有 一 个 函数 void onAutoFocus(boolean 
success, Camera camera); 当 自 动 对 焦 成 功 时 success 参数 的 值 为 tue， 和 否则 为 false。 

Interface android.hardware.Camera.ErrorCallback 

当 摄像 头 出 错 的 时 候 调 用 , 该 接口 具有 一 个 函数 void onError(int error, Camera camera); 
参数 error 为 错误 类 型 ， 其 取 值 为 Camera 类 中 的 常量 CAMERA_ERROR_UNKNOWN 或 
CAMERA ERROR _ SERVER _DIED; 前 者 表明 错误 类 型 不 明确 ， 后 者 表明 服务 已 关闭 ,在 
这 种 情况 下 必须 释放 当前 的 Camera 对 象 然后 重新 初始 化 一 个 。 

Interface android.hardware.Camera.PreviewCallback 

在 图 像 预览 时 候 调 用 ， 该 接口 具有 一 个 函数 void onPreviewFrame(byte[] data, Camera 
camera); 参数 data 为 每 帧 图 像 的 数据 流 。 

Interface android.hardware.Camera.ShutterCallback 

当 摄像 头 快门 关闭 的 时 候 调 用 ， 该 接口 具有 一 个 函数 void onShutter0; 可 以 在 该 函数 
中 通知 用 户 快门 已 关闭 ， 例 如 播放 一 个 声音 。 


Interface android.hardware.Camera.PictureCallback 





当 拍 摄 照 片 的 时 候 调 用 ， 该 接口 具有 一 个 函数 void onPictureTaken(byte[] data, Camera 
camera); 参数 data 为 拍摄 照片 的 数据 流 。 

在 本 例 中 ， 只 需要 在 拍摄 照片 时 保存 拍摄 的 图 片 ， 实 现 该 回调 接口 如 下 : 

01 // 拍 照 后 保存 图 片 
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02 Public Camera.PictureCallback pictureCallback = new Camera. 
PictureCallback() { 
D3 
04 public void onPictureTaken (byte[] data, Camera camera) { 
05 Toast .makeText (getApplicationContext ()，" 正 在 保存 …"， 
1000) .show(); 
06 // 用 BitmapFactory.decodeByteArray() 方 法 把 相机 传 回 的 数据 
转换 成 Bitmap 对 象 
07 mBitmap = BitmapFactory.decodeByteArray (data, 0, data. 
length); 
08 new DateFormat (); 
09 // 接 下 来 的 工作 就 是 把 Bitmap 保存 成 一 个 存储 卡 中 的 文件 
10 PathString = "/sdcard/" 
h + DateFormat.format ("yyyyMMdd hhmmss", 
2 Calendar .getInstance (Locale .CHINA)) + ".jpg"; 
// 形 成 文件 名 
3 File file = new File(pathString) 7 // 初 始 化 文件 类 
14 try { 
ES file.createNewFile(); // 创 建新 文件 
16 BufferedoutputStream os = new BufferedOutputStream( 
于 new FileOutputStream(file)); // 设 置 输出 流 
18 mBitmap. compress (Bitmap.CompressFormat.PNG, 100, os); 
// 保 存 图 片 
于 和 os.flush() > 
20 os.close(); 
Fal Toast.makeText (getApplicationContext(), "图 片 保存 完毕 "， 
1000) .show(); 
bd } catch (IOException e) { 
之 3 e.printStackTrace (); 
24 . 
25 } 
26 
27 }; 


其 中 ，02 行 ， 实 现 了 Camera.PictureCallback 接口 ; 

04 行 ， 接 口中 的 onPictureTaken() 方 法 ， 其 中 参数 data 是 拍摄 照片 的 数据 流 ; 
06 一 07 行 ， 将 照片 数据 流转 为 Android 中 的 图 片 类 ; 

08 一 12 行 ， 设 置 保存 的 文件 名 ， 该 文件 以 拍摄 照片 的 时 间 为 文件 名 ; 

13 一 24 行 ， 将 图 片 数 据 保存 为 图 片 文件 。 


6. 拍照 实现 


经 过 前 面 的 步 又， 我 们 已 经 实现 了 拍照 的 预览 和 照片 保存 ， 但 是 其 关键 的 拍摄 功能 还 
没有 实现 。 在 相机 类 Camera 中 ， 提 供 了 拍照 的 两 种 方法 : 

final void takePicture (Camera.ShutterCallback shutter, 

Camera.PictureCallback raw, Camera.PictureCallback jpeg) 

final void takePicture (Camera.ShutterCallback shutter, 

Camera.PictureCallback raw, Camera.PictureCallback postview, 

Camera.PictureCallback jpeg) 

其 中 ， 参 数 分 别 对 应 着 相机 Camera 中 不 同 状态 的 接口 。 在 本 例 中 ， 我 们 只 需要 保存 
拍摄 的 图 片 ， 实 现 PictureCallback 接口 即 可 。 

当然 ， 为 了 实现 对 拍摄 照片 的 查看 ， 当 返回 功能 选择 界面 时 ， 将 当前 拍摄 的 照片 的 保 
存 地 址 传递 回 功能 选择 界面 中 。 这 些 功 能 在 按键 处 理事 件 中 实现 ， 有 具体 代码 如 下 ; 
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01 public boolean onKeyDown (Int keyCode, KeyEvent event) { 


02 
03 


04 
05 
06 
07 


08 
09 
10 
11 
3 
3 
14 


15 
16 
到 
18 
于 9 
20 
2 


上 


System-out .println (keyCode); 
//if (keyCode == KeyEvent.KEYCODE CAMERA) { 


// 点 击 拍照 按钮 。 由 于 模拟 器 中 无 法 使 用 该 按钮 ， 下 面 使 用 键盘 中 间 键 车 换 
if (keyCode == KeyEvent.KEYCODE DPAD CENTER) { // 单 击 中 间 键 


if (mCamera != null) { 
// 当 按 下 相机 按钮 时 ， 执 行 相机 对 象 的 takePicture () 方 法 ， 该 方法 
有 3 个 回调 对 象 作 为 参数 ， 不 需要 的 时 候 可 以 设 nul1 


mCamera.takePicture(null, null, pictureCallback); 


} 
} else if (keyCode == KeyEvent.KEYCODE BACK) { 
// 单 击 返回 键 时 ， 传 回 图 片 地址 
Bundle bundle = new Bundle(); 
bundle.putString ("PATH"，pathString); // 传 递 文件 保存 路 径 
Self camera.this.setResult (RESULT OK, 
Self camera.this.getIntent () 
.putExtras (bundle) ) ; // 带 数据 的 返回 
Self camera.this.finish(); // 结 束 当前 界面 


super.onKeyDown (keyCode, event); 
return true; 


其 中 ，03 一 9 行 ， 实 现 拍 照 功能 。 由 于 在 模拟 器 中 不 能 使 用 照相 按钮 ， 使 用 正中 间 的 
按钮 来 触发 拍照 功能 ， 如 图 6.14 所 示 。 
10 一 18 行 ， 单 击 返回 键 时 ， 传 递 保 存 的 图 片 地 址 到 功能 选择 界面 。 
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图 6.14 拍照 


以 上 步骤 ， 我 们 实现 了 一 个 简易 的 相机 。 如 果 在 模拟 器 中 运行 该 代码 ， 需 要 设置 
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模拟 器 支持 相机 的 功能 。 在 模拟 器 管理 中 ， 编 辑 模拟 器 。 在 其 硬件 支持 中 ， 添 加 Camera 
support， 如 图 6.15 所 示 。 
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图 6.15 添加 相机 支持 


给 模拟 器 添加 了 相机 的 硬件 支持 后 ， 可 以 在 模拟 器 中 使 用 我 们 实现 的 简易 相机 。 当 拍 
照 完成 时 ， 提 示 保 存 图 片 完 成 ， 如 图 6.16 所 示 。 当 成 功 拍照 后 ， 返 回 到 功能 选择 界面 时 ， 
就 可 以 显示 拍摄 的 照片 了 。 由 于 在 模拟 器 中 ， 成 功 拍照 后 都 生成 Android 系统 默认 的 机 器 
人 图 片 ， 效 果 如 图 6.17 所 示 。 
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图 6.16 图 片 保存 图 6.17 显示 拍摄 的 图 片 
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6.4.3 ”照相 总 结 


在 本 节 中 ,我 们 分 别 使 用 系统 本 身 的 照相 机 和 使 用 Camera 类 来 实现 自己 的 拍照 程序 。 
主要 讲解 了 自 定义 拍照 程序 中 ，Camera 类 作为 拍照 功能 实现 的 关键 类 。 对 于 Camera 类 的 
使 用 ， 主 要 需要 的 是 实现 其 状态 控制 的 接口 ， 来 完成 图 片 的 保存 。 

在 模拟 器 中 , 测试 照相 程序 存在 一 定 的 局 限 性 , 只 能 验证 自身 代码 是 否 存 在 逻辑 错误 ， 
而 对 于 拍照 的 细节 是 需要 通过 真 机 来 进行 测试 的 。 


6.5 条 纹 码 识别 器 


在 我 们 日 常生 活 中 ， 我 们 随处 可 以 看 到 条 纹 码 和 二 维 码 。 对 于 条 纹 码 ， 在 商品 、 图 书 
等 产品 中 一 般 都 有 。 其 可 以 标 出 物品 的 生产 国 、 制 造 三 家 、 商 品名 称 、 生 产 日 期 、 图 书 分 
类 号 、 邮 件 起 止 地 点 、 类 别 、 日 期 等 许多 信息 。 当 然 ， 条 纹 码 包含 的 信息 有 限 ， 从 而 出 现 
了 二 维 码 ， 在 二 维 码 中 可 以 包含 更 多 的 信息 。 当 前 的 手机 设备 在 二 维 码 中 保存 URL 地 址 ， 
通过 二 维 码 可 以 为 网 络 浏览 、 下 载 、 在 线 视频 、 网 上 购物 、 网 上 支付 等 提供 方便 的 入 口 。 

在 本 节 中 ,我 们 将 实现 一 个 条 纹 码 、 二 维 码 的 识别 器 ， 可 以 读 取保 存在 一 /二 维 码 中 的 
信息 ， 从 而 加 深 对 Android 手机 获取 图 像 的 理解 。 


6.5.1 条 纹 码 识别 库 


条 形 码 具 有 自己 的 一 套 编码 规则 ， 使 用 该 规则 进行 编码 、 解 码 的 算法 也 比较 成 熟 。 我 
们 使 用 ZXing 库 来 实现 对 一 /二 维 码 的 识别 。 


1. ZXing 库 介绍 


ZXing 是 一 个 解析 多 种 格式 的 1D/2D 条 形 码 的 开源 Java 类 库 , 其 目标 是 能 够 对 QR 编 
人 码 、Data Matrix、UPC 进行 解码 ， 其 作用 主要 也 是 解码 ， 是 目前 开源 类 库 中 解码 能 力 比较 
强 的 。 但 是 ， 它 要 求 摄像 头 具有 自动 对 焦 功 能 。 在 现 有 Android 的 绝 大 部 分 手机 设备 都 是 
具有 自动 对 焦 功 能 的 。 

ZXing 首页 地 址 为 http://code.google.com/p/zxing/， 如 图 6.18 所 示 。 可 以 看 出 它 同 样 提 
供 了 cpp、ActionScript、Android、IPhone、Rim、J2me、J2se、Jruby、C# 等 方式 的 类 库 ， 
可 以 对 多 个 平台 进行 支持 。 

在 ZXing 的 项 目 首页 可 以 下 载 类 库 的 完整 包 。 在 包 中 针对 不 同 平台 分 别 有 其 对 应 的 演 
示 代 码 ， 在 Android 系统 中 重点 关注 的 包 有 : 

口 Core: 核心 库 ， 包 括 了 主要 的 解码 库 以 及 测试 代码 。 

口 Android: 一 个 名 为 Barcode Scanner 的 Android 端 解码 器 。 在 掌握 了 基本 的 条 纹 解 

码 器 的 基础 上 ， 可 以 阅读 分 析 该 代码 来 加 深 条 纹 码 识别 器 的 理解 。 
口 Androidtest: Android 解码 器 的 测试 代码 。 
口 Android-integration: 实现 对 Barcode Scanner 的 外 部 调用 。 
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ZXing ("Zebra Crossing") 


Ding (pronounced "zebra crossing") is an open-source, multi- 
other languages. Our focus is on using the built-in camera on 
communicating with a server. However the project can be use' 
support these formats: 


» UPC-A and UPC-E 
» EAN-8 and EAN-13 
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EAN, Code39, Code128, *» Code 93 
ITF, RSs14 » Code 128 

。QR Code 


图 6.18 ZXing 首页 


2. 编译 Core 库 


我 们 使 用 ZXing 库 来 完成 对 一 /二 维 码 的 解码 工作 。 但 是 ， 在 ZXing 项 目 中 ， 提 供 了 
完整 的 源码 ， 但 是 没有 提供 编译 完成 的 库 文件 下 载 。 在 使 用 ZXing 库 时 ， 可 以 将 该 库 的 所 
有 源 文件 复制 到 项 目 工 程 中 ， 也 可 以 通过 源 文件 编译 成 库 文件 然后 直接 使 用 该 库 文件 。 在 
这 里 ， 我 们 事先 编译 生成 库 文件 ， 方 便 在 其 他 需要 的 时 候 使 用 。 

(1) 依赖 库 下 载 

在 编译 ZXing 核心 库 时 ， 需 要 使 用 到 Proguard 和 Ant。 需 要 先 下 载 这 两 个 工程 。 

其 中 ，Proguard 是 一 个 压缩 、 优 化 和 混淆 Java 字 节 码 文件 的 免费 的 工具 ， 它 可 以 删除 
无 用 的 类 、 字 段 、 方 法 和 属性 。 其 下 载 地 址 为 http://proguard.sourceforge.net/index. 
html#downloads.html， 如 图 6.19 所 示 。 下 载 完成 后 ， 解 压 到 自己 需要 的 工作 目录 即 可 。 











TD 2 
Pro(suard 
Mais Downloads 
Results 
ProGuard is distnibuted under the terms of the GNU General Public License. Please consult the license page for more dt 
FAQ 
二 ProGuard is written in Java, so tt requires a Java Runtime Environment (JRE 1.4 or higher). 
| You can download the latest release (containing the program jar, the documentation you're reading now, examples, and t 
nm 
i Download section (at SourceForge) 


图 6.19 ”Proguard 下 载 


对 于 Ant， 大 家 也 非常 熟悉 ， 它 是 一 种 基于 Java 的 构建 工具 。 其 下 载 地 址 为 http:// 
ant.apache.org/。 下 载 完 成 后 解压 到 工作 目录 中 ， 然 后 需要 配置 其 环境 变量 。 
在 Windows 平台 中 ， 选 择 其 环境 变量 进行 添加 ， 如 图 6.20 所 示 。 
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图 6.20 添加 Ant 环境 变量 


添加 Ant 的 环境 变量 ， 分 别 添加 Ant 的 目录 和 系统 调用 路 径 ， 添 加 内 容 如 下 : 


RNT_HOME 
E:\Android\tools\apache-ant-1.8.2 
PATH 
E:\Android\tools\apache-ant-1.8.2\bin 


添加 完成 后 ， 需 要 验证 是 否 添加 成 功 。 在 命令 控制 台中 输入 Ant。 如 果 出 现 不 是 可 用 
命令 则 表明 未 添加 成 功 ， 出 现 build failed 则 表明 添加 成 功 。 整 个 判断 过 程 如 下 : 
01 D:\Documents and Settings\Owner>ant 


02 "ant' 不 是 内 部 或 外 部 命令 ， 也 不 是 可 运行 的 程序 
03 ”或 批 处 理 文件 

04 

05 D:\Documents and Settings\Owner>ant 
06 Buildfile: build.xml does not exist! 
07 Build failed 


(2) ZXing 下 载 
在 ZXing 项 目 首页 中 选择 Downloads, 便 会 出 现 可 下 载 的 文件 .其 中 , ZXing 1.7 Release 
表明 该 文件 是 ZXing 库 的 源 文件 ， 选 择 下 载 该 文件 包 ， 如 图 6.21 所 示 。 


条 江 ZXing 


S| Munifomat TD/2D barcode image processing ibrary with clients for Android, Jana 


ProiectHome | Downloads | Wiki lssues Source 
Search Curentdownloads ”区 fo Search 











Filename v Summary * Labels v 
§) BarcodeScannerdebug apk Barcode Scanner 4.0 beta2 for Android 2.1+ Feahued 
[E] PingTestl 2betal.apk Daing Test 1.2 beta 1 for Android (for developers only) 
| BarcodeScannerd72.3pk 。 Barcode Scanner 3.72 for Android Feztomd 








国 zaetzz Ding 17 Release Festued 
于 ] BarcodeScannei3 Barcode Scanner36 for Android 
梧 | Ding16zip Zng 16 release 
本 ] Zinorestl12apk Dang Test 1.12 for Android (or developers only) 


图 6.21 ZXing 压缩 包 
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下 载 完 成 解压 该 下 载 包 ， 其 中 包含 了 ZXing 针对 所 有 平台 的 源 文件 ， 包 括 了 cpp、 
ActionScript、Android、IPhone、Rim、J2me、J2se、Jruby 等 多 个 文件 夹 和 build.properties 
等 文件 ， 对 于 Android 系统 ， 要 重点 关注 core、android 文件 夹 和 build.properties 文件 ， 如 
图 6.22 所 示 。 





文件 四 ”编辑 外 查看 @ 收藏 人 ) 工具) 帮助 0 


Oi © 访 Pr 也 xx 回 - 


地 址 四 ) | 书 B: Mndroid\tools\ZXinel.T\rxing 





] AVTHORS 
i tt. i 文件 
xing appspot. com [sal xingorg 图 站 
build ti | build ties build xml 
图 PRP 安 伴 图 DK XHL Doconent 
2 亚 2 5 地 
CoPYTNG READNE 
件 文件 
hb 国 | 泪 











图 6.22 ZXing 目录 


(3) ZXing 编译 

需要 编译 的 是 core 文件 夹 中 的 内 容 ， 编 译 该 目录 中 的 文件 ， 需 要 对 build.properties 文 
件 进 行 修改 配置 。 

打开 build.properties， 找 到 proguard-jar= 内 容 ， 其 用 于 指定 刚才 下 载 的 proguard 的 lib 
目录 下 的 proguard.jar; 找到 android-home= 内 容 ， 其 用 于 指定 Android SDK 的 目录 地 址 。 
针对 不 同 的 地 址 进行 修改 。 需 要 注意 的 是 ， 对 于 多 级 目录 的 分 隔 使 用 “/” 或 者 “\N” 来 实 
现 。 修 改 如 下 : 

proguard-jar=E:\\Android\\tools\\proguard4.7\\lib\\proguard.jar 

android-home=E:\\Android\\tools\\android-sdk-windows 

使 用 命令 控制 台 来 对 core 中 的 文件 进行 编译 。 首 先进 入 core 目录 中 ， 直 接 输 入 ant， 
提示 build successful 即 表示 编译 成 功 。 整 个 实现 过 程 如 下 : 


E:\>cd E:\Android\tools\ZXing-1.7\zxing\core 
E:\Android\tools\ZXing-1.7\zxing\core>ant 

Buildfile: E:\Android\tools\ZXing-1.7\zxing\core\build.xml 
clean: 

build: 

六 nn 

compile: 
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[mkdir] Created dir: E:\Android\tools\ZXing-1.7\zxing\core\build 
[javac] Compiling 177 source files to E:\Android\tools\ZXing-1.7\ 
zxing\core\ 
build 
[jar] Building jar: E:\Android\tools\ZXing-1.7\zxing\core\core.jar 


BUILD SUCCESSFUL 
Total time: 8 seconds 


成 功 编译 core 后 ， 在 core 文件 夹 中 将 会 出 现 名 为 corejar 的 一 个 文件 。 该 文件 就 是 我 
们 用 于 对 条 纹 码 进行 解码 的 核心 库 ， 如 图 6.23 所 示 。 










文件 到 ) 编辑 EE) 查看 WD 收藏 人 工具 他) 和 天 助 D 


| Os - © 售 Dr xn 回 - 





地 址 DE Wadroid\tools\Iine 1 T\rxing\eore 














ej 
cutable Jar 了 il 
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Sere 
文件 到 

修改 日 期 : 2011 年 6 月 8 日 ， 
15:50 


图 6.23 成 功 编译 


6.5.2 条纹 码 获 取 


对 于 条 纹 码 的 解析 ， 我 们 使 用 ZXing 库 来 实现 。 而 对 于 条 纹 码 的 获取 ， 我 们 使 用 类 似 
于 拍照 的 情形 来 及 时 获取 摄像 头 捕获 的 图 像 。 因 为 我 们 使 用 摄像 头 来 获取 条 纹 码 ， 需 要 申 
请 相应 的 权限 ， 在 AndroidManifest xml 文件 中 实现 如 下 : 


<uses-permission 
android:name="android.permission.CAMERA"></uses-permission> 
<uses-permission 

android:name="android.permission.WRITE EXTERNAL STORAGE"></uses-permiss 
ion> 

<uses-feature android:name="android.hardware.camera" /> 

<uses-feature android:name="android.hardware.camera.autofocus" /> 


1. 界面 布局 


在 界面 布局 中 ， 我 们 提 到 了 帧 布局 。 由 于 是 将 多 个 控件 重合 地 排 布 在 界面 中 ， 在 之 后 
的 实际 使 用 中 ， 我 们 并 没有 用 到 这 样 的 布局 。 在 这 里 ， 我 们 使 用 帧 布局 。 在 布局 下 层 显示 
获取 的 实时 图 像 ， 在 实时 图 像 上 层 显示 解析 结果 ， 界 面 设计 如 图 6.24 所 示 。 

在 该 布局 中 ， 下 层 是 一 个 SurfaceView 的 控件 用 于 显示 获取 的 实时 图 像 。 在 它 之 上 是 
一 个 线性 的 布局 ， 分 别 显示 解析 的 条 纹 码 图 像 、 条 纹 码 解析 选择 区 块 、 解 析 结 果 显 示 ， 具 
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体 实现 如 下 : 





图 6.24 界面 设计 


<?xml version="1.0" encoding="utf-8"?> 

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/FrameLayout01" 
android:layout width="fill parent" 
android:layout height="fill parent" > 





<SurfaceView 
android:id="@+id/sfvCamera" 
android:layout width="fill parent" 
android:layout height="fill parent" > 
</SurfaceView> 


<LinearLayout 
android:layout width="fill parent" 
android:layout height="fill] parent" 
android:orientation="vertical" > 


<ImageView 
android:id="@+id/ImageView01" 
android:layout width="160dip" 
android:layout height="100dip" > 
</ImageView> 


<View 
android:id="@+id/centerView" 
android:layout width="300dip" 
android:layout height="180dip" 
android:layout centerHorizontal="true" 
android:layout gravity="center" 
android:background="#55FF6666" > 

</View> 


<TextView 


android:id="@+id/txtScanResult" 
android:layout width="wrap content" 
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android:layout height="wrap content" 


android:layout gravity="center" 
android:text="Scanning..." > 
</TextView> 
</LinearLayout> 
</FrameLayout> 


2. 图 像 显 示 


在 图 像 显 示 中 ， 我 们 使 用 SurfaceView 来 显示 来 自 摄像 头 的 及 时 的 图 像 数 据 。 在 照相 
机 实现 时 ， 我 们 详细 介绍 过 ， 使 用 SurfaceView 来 显示 图 像 主要 分 为 4 部 分 : 一 是 在 实例 
化 时 , 设置 接口 的 回调 函数 、 获 取 的 数据 源 等 ， 二 是 在 视图 创建 时 ， 启 动 相 机 并 进行 设置 ; 
:是 在 图 像 变 化 时 ， 对 相机 相关 参数 进行 设置 并 开始 预览 ， 四 是 在 视图 销毁 时 ， 停 止 预览 
并 释放 相机 资源 。 

熟悉 了 图 像 显示 的 流程 和 关键 操作 ， 有 具体 实现 如 下 : 

01 public class SurafaceCamera implements SurfaceHolder.Callback{ 























// 实 现 回 调 接口 
02 private SurfaceHolder holder = null; // 定 义 控制 类 
03 private Camera mCamera; // 定 义 照 相 类 
04 private Camera.PreviewCallback previewCallback;// 定 义 回 调 类 
05 private int width,height; // 定 义 图 片 的 高 度 、 宽 度 
06 
07 public SurafaceCamera (int width，int height, SurfaceHolder 
holder,Camera.PreviewCallback 
08 previewCallback) { // 构 造 函 数 
09 this.width=width; 
10 this.height=height; 
1 this.holder = holder; 
2 this.holder.addCallback (this); 
13 this.holder.setType (SurfaceHolder .SURFACE TYPE PUSH BUFFERS); 
14 this.previewCallback=previewCallback; 
15 } 
16 
pi @Override 
18 Public void surfaceCreated(SurfaceHolder arg0) { 
19 mCamera = Camera.open(); // 启 动 服务 
20 try { 
2 mCamera.autoFocus (mAutoFocusCallBack); 
22 mCamera.setPreviewDisplay (holder); // 设 置 预览 
总 3 
24 } catch (IOException e) { 
25 mCamera.release(); // 释 放 
26 mCamera = null; 
2 } 
28 1 
29 @Override 
30 Public void surfaceChanged (SurfaceHolder arg0, int argl, int arg2, 
int arg3) { 
31 Camera .Parameters parameters = mCamera.getParameters () : 
// 获 取 参 数 设置 类 
3 parameters.setPictureFormat (PixelFormat .JPEG); 
// 设 置 图 片 编码 类 型 
33 Parameters .setPreviewSize (width, height); // 设 置 图 片 大 小 
34 Parameters .setFocusMode ("auto"); // 设 置 自动 对 焦 
3 mCamera. setParameters (parameters); // 添 加 照相 机 设置 
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mCamera.startPreview(); // 开 始 预 览 

} 

Q@Override 

public void surfaceDestroyed(SurfaceHolder arg0) { 
mCamera.setPreviewCallback (nul1) : // 预 览 图 片 回 调 
mCamera.stopPreview() : // 停 止 预览 
mCamera.release (); // 释 放 资 源 
mCamera = null; 

上 


其 中 ，07 一 15 行 ， 进 行 类 实例 化 ， 设 置 接口 的 回调 函数 和 获取 的 数据 源 ; 
17 一 27 行 ， 进 行 视图 创建 时 的 处 理 ， 启 动 相机 并 设置 其 显示 控件 以 及 异常 处 理 ; 





29 一 37 行 ， 进 行 图 像 变 化 时 的 处 理 ， 设 置 图 片 编码 类 型 、 大 小 、 自 动 聚 焦 等 参数 并 开 
始 预 览 获 取 的 图 像 ; 


40 一 46 行 ， 进 行 视图 销毁 时 的 处 理 ， 停 止 预览 、 释 放 资 源 等 。 
3. 自动 对 焦 调 用 


当 实现 自动 对 焦 时 ， 就 获取 此 时 显示 的 图 像 并 从 图 像 中 读 取 条 纹 码 信息 ， 这 样 可 以 保 
证 不 会 错过 条 纹 码 图 像 。 在 Camera 类 中 有 自动 对 焦 的 接口 Camera.AutoFocusCallback, 在 
其 中 实现 获取 此 时 的 图 像 帧 ， 具 体 实现 如 下 : 


01 


02 
03 
04 
05 
06 
07 
08 
09 
10 


Private Camera.AutoFocusCallback mAutoFocusCallBack = new Camera. 
AutoFocusCallback() { 


@Override 
Public void onAutoFocus (boolean success, Camera camera) { 
if (success) { // 对 焦 成 功 ， 获 取 图 像 


mCamera.setOneShotPreviewCallback (PreviewCallback) : 
System.out .Println("autofocus callback"); 
1 
} 
] 


其 中 ，01 行 ， 实 现 自 动 对 焦 AutoFocusCallback 接口 ; 


04 行 ， 


重 写实 现 接 口中 的 自动 对 焦 方法 ; 











05 一 06 行 ， 判 断 是 否 对 焦 成 功 ， 当 对 焦 成 功 时 ， 调 用 setOneShotPreviewCallback() 方 
法 来 处 理 该 图 像 。 
4. 条 纹 码 识别 


对 于 条 纹 码 的 识别 ， 我 们 使 用 ZXing 库 来 完成 。 在 使 用 该 库 时 ， 在 项 目 中 添加 该 库 文 
件 。 添 加 库 文件 时 ,只 需要 在 项 目 属性 框 中 的 Java Build Path|Libraries 选项 卡 中 , 单 击 Add 
JARs 按钮 ， 在 弹出 的 对 话 框 中 选择 需要 添加 的 库 文 件 即 可 ， 如 图 6.25 所 示 。 

在 本 实例 中 ， 不 仅仅 使 用 到 了 ZXing 核心 库 中 的 条 纹 码 图 像 识别 的 功能 ， 还 使 用 了 其 
Android 条 纹 码 识别 器 中 的 区 域 图 像 的 获取 功能 。 对 于 该 区 域 图 像 的 获取 功能 ， 我 们 直接 
使 用 ZXing 库 中 的 Android 文件 夹 下 的 源码 。 对 于 区 域 图 像 获取 ， 需 要 源码 中 的 
PlanarYUVL- uminanceSource.java 文件 ， 该 文件 在 \src\com\google\zxing\client\android 中 。 
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添加 了 库 文件 和 源 文件 后 ， 工 程 目录 如 图 6.26 所 示 。 
3 [x] 


Java Build Path OO bd 
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图 6.25 添加 库 文件 
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图 6.26 工程 目录 
在 ZXing 核心 库 中 ， 使 用 MultiFormatReader 类 来 从 图 片 中 读 取 条 纹 码 。 获 取 了 条 纹 
码 信息 后 ， 就 可 以 直接 获取 该 条 纹 码 的 编码 方式 和 内 容 。 具 体 实现 如 下 : 


01 private Camera.PreviewCallback previewCallback = new Camera. 
PreviewCallback() { 





02 @Override 

03 public void onPreviewFrame (byte[] data, Camera argl) { 

04 // 取 得 指定 范围 的 帧 的 数据 

05 if (dstLeft == 0) { 

06 dstLeft = centerView.getLeft() * width 

07 / getWindowManager () .getDefaultDisplay() .getWwidth (); 
08 dstTop = centerView.getTop() * height 

09 / getWindowManager () .getDefaultDisplay() .getHeight (); 
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10 dstWidth = (centerView.getRight() - centerView.getLeft())* width 
a / getWindowManager () .getDefaultDisplay() .getWidth(); 
2 dstHeight = (centerView.getBottom() - centerView.getTop())* height 
3 / getWindowManager () .getDefaultDisplay() .getHeight (); 
14 
15 PlanarYUVLuminanceSource source = new PlanarYUVLuminanceSource( 
16 data, width, height, dstIeft, dstTop, dstWidth, dstHeight, false) ; 
Ug // 取 得 灰 度 图 
18 Bitmap mBitmap = source.renderCroppedGreyscaleBitmap () 
19 // 显 示 灰 度 图 
20 imgView.setImageBitmap (mBitmap); 
让 BinaryBitmap bitmap = new BinaryBitmap (new HybridBinarizeT 

(source) ) 7 
22 MultiFormatReader reader = new MultiFormatReader () : 

// 实 例 化 条 纹 码 读 取 类 
23 try 
24 Result result = reader.decode (bitmap); 
// 获 取 条 纹 码 读 取 结果 类 

党 String strResult = "条 纹 码 格式 是 :" 
26 + result.getBarcodeFormat() .toString() + " 内 容 是 :" 
27 + result.getText(); // 显 示 读 取 内 容 
28 txtScanResult.setText (strResult); 
29 } catch (Exception e) { 
30 txtScanResult .setText ("Scanning"); 
31 } 
32 } 
33 }; 


其 中 ，05 一 16 行 ， 获 取 指 定 显示 区 域内 的 图 像 ; 

22 行 ， 实 例 化 一 个 条 纹 码 图 片 读 取 类 ; 

24 行 ， 读 取 有 条 纹 码 的 图 片 ， 从 中 获取 条 纹 码 信 息 结果 ; 

25 一 27 行 ， 从 信息 结果 中 获得 条 纹 码 的 格式 以 及 内 容 。 

在 模拟 器 中 由 于 没有 真实 的 摄像 头 获 取 图 像 ， 效 果 如 图 6.27 所 示 。 其 中 ， 左 上 方 的 小 
的 黑白 格 图 案 是 自动 对 焦 时 获取 的 图 像 ， 中 心 红色 区 域 是 读 取 条 纹 码 的 指定 区 域 ， 只 有 将 
条 纹 码 图 案 放置 在 该 区 域 中 才能 被 捕获 并 正常 识别 ， 下面 的 scanning 表示 正在 搜索 图 像 ， 
如 果 识 别 了 条 纹 码 ， 这 里 将 显示 条 纹 码 信息 。 


JE 


- 





图 6.27 模拟 器 识别 
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6.5.3 ”条纹 码 总 结 


在 本 节 中 ， 我 们 实现 了 一 维 条 形 码 和 二 维 码 的 识别 ， 可 以 从 这 些 条 形 码 中 解析 出 其 信 
息 。 主 要 讲解 了 开源 的 条 纹 码 识别 ZXing 核心 库 的 编译 和 使 用 ， 本 节 再 次 使 用 摄像 头 获取 
图 片 信息 ， 大 家 应 熟练 掌握 摄像 头 获取 数据 并 实时 显示 的 使 用 。 

但 是 ， 在 本 实例 中 只 实现 了 解析 条 纹 码 的 功能 ， 对 于 解析 的 条 纹 码 信息 没有 再 进行 处 
理 。 可 以 将 获取 的 条 纹 码 信息 进行 联网 查询 ， 从 而 获取 更 多 的 信息 。 例 如 ， 商 品 的 防伪 信 
息 、 图 片 的 下 载 地 址 、 网 络 视频 地 址 等 。 


6.6 本 章 总 结 


本 章 介 绍 了 Android 中 多 媒体 的 相关 知识 。 通 过 音频 的 播放 和 录制 、 视 频 的 播放 以 及 
照片 的 拍摄 实例 讲解 了 MediaPlayer、MediaRecorder 以 及 Camera 类 的 常用 方法 和 使 用 。 这 
3 个 类 是 Android 中 多 媒体 的 最 重要 的 类 ， 在 进行 与 多 媒体 技术 相关 的 开发 时 ， 这 些 是 必 
须 掌握 的 知识 。 对 于 音 视频 的 播放 和 录制 是 本 章 的 重点 也 是 多 媒体 技术 使 用 的 基础 ， 在 实 
际 开发 中 要 能 够 熟练 使 用 。 对 于 获得 音 视 频 信息 后 的 处 理 ， 则 是 需要 在 不 断 的 实践 中 进行 
深入 的 研究 与 提高 。 


6:7 习 题 


【习题 1】 结 合 6.1 节 音 乐 播放 器 的 内 容 ， 实 现 网 络 播放 器 的 功能 。 
外 提示 : 在 多 媒体 播放 类 MediaPlayer 中 ， 可 以 直接 播放 网 络 地 址 的 歌曲 。 
关键 代码 : 


MediaPlayer mediaPlayer; 

Uri uri=Uri.parse("http://www-XXxX-Com-XxXx-mp3") 7 
mediaPlayer=MediaPlayer.create (context, uri); 
mediapPlayer.start (); 


【习题 2】 结合 6.2 节 音 频 录 制 的 相关 内 容 ， 实 现 录 制 多 个 音频 的 功能 。 


名 提示 : 录制 多 个 音频 和 录制 单个 音频 文件 的 差别 在 于 对 录制 的 每 一 个 文件 都 单独 进行 
保存 ， 不 履 盖 已 有 文件 。 


关键 代码 : 


MediaRecorder mr = new MediaRecorder (); 

mr.setAudioSource (AudioSource -MIC) 7 

mr.setOoutputFormat (OutputFormat .RAW RMR) 

mr.setAudioEncoder (MediaRecorder .AudioEncoder.AMR NB) 

SimpleDateFormat formatter = new SimpleDateFormat ("yyyy MM dd HH:mm:ss"); 
Date curDate = new Date (System.currentTimeMillis()); // 获 取 当 前 时 间 
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String filepath = "mnt/sdcard/"+formatter.format (curDate)+".amr™" 7 


File file=new File(filepath); 


while (file.exists())t{ 
filepath=filepath.substring(0, filepath.lastIndexOf('.'))+"1.amr"; 


file=new File(filepath); 
|， 


MediaRecorder mr = new MediaRecorder (); 
mr.setOutputFile (filepath); 


【习题 3】 结合 6.4 节 照 相机 的 相关 内 容 ， 实 现 三 连 拍 的 功能 。 





全 提示 : 实现 三 连 拍 即 在 一 次 拍照 后 间隔 一 段 时 间 再 次 拍照 ， 但 是 如 果 再 直接 拍照 会 产生 
异常 ， 需 要 停止 预览 然后 再 预览 才能 进行 下 一 次 的 拍照 。 
关键 代码 : 
FOr (ne = 0 Te 3 
mCamera.takePicture (null, null, pictureCallback); 


mCamera.stopPreview(); 


sleep(500); 
mCamera.startPreview(); 


} 
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在 前 面 的 章节 中 ， 我 们 已 经 介绍 了 Android 系统 中 的 数据 存储 、 网 络 通 信 以 及 多 媒体 
的 相关 开发 ， 这 些 开发 与 在 PC 机 上 使 用 标准 Java 进行 开发 有 一 定 相似 之 处 。 在 接 下 来 的 
章节 中 , 我 们 将 介绍 更 具有 Android 系统 特色 的 相关 开发 , 如 短信 开发 、 传 感 器 使 用 、 NDK 
开发 等 。 

智能 手机 作为 目前 Android 系统 的 最 大 载体 , Android 系统 必须 解决 手机 最 基本 的 两 大 
需求 一 一 语音 通话 和 短信 。 在 本 章 中 ， 将 主要 围绕 Android 手机 中 这 两 个 需求 进行 实例 讲 
解 ， 同 时 还 会 介绍 Android 的 桌面 组 件 AppWidget。 





7.1 短信 导出 


短信 作为 当今 人 和 人 交流 中 非常 重要 的 方式 ， 珍 藏 着 大 家 不 同时 期 的 心情 和 成 长 。 但 
是 ， 手 机 的 存储 空间 是 有 限 的 ， 对 于 那些 来 自重 要 号 码 的 短信 、 需 要 保存 的 短信 ， 我 们 可 
以 采用 导出 文本 的 方式 ， 将 短信 保存 到 有 足够 空间 的 PC 等 有 大 存储 空间 的 设备 上 。 接 下 
来 ， 我 们 来 实现 如 何 将 短信 和 导出 为 文本 。 


7.1.1 系统 短信 的 保存 


在 介绍 数据 存储 的 章节 中 ， 我 们 介绍 过 ， 在 Android 系统 中 ， 对 于 共享 数据 使 用 
ContentProvider 来 提供 给 所 有 应 用 程序 使 用 。 短 信和 同样 是 以 数据 库 的 形式 保存 在 系统 中 。 


1. 添加 短信 


短信 程序 是 Android 手机 系统 中 必 不 可 少 的 应 用 程序 ， 系 统 中 自 带 了 名 为 Messaging 
的 短信 程序 。 在 系统 主 界面 中 ， 我 们 可 以 很 容易 地 找到 该 程序 ， 如 图 7.1 所 示 。 单 击 该 程 
序 ， 我 们 可 以 看 到 我 们 在 手机 中 保存 的 所 有 短信 ， 如 图 7.2 所 示 ， 手 机 中 有 3 条 与 号 码 为 
234 的 短信 会 话 记 录 、 有 12 条 与 号 码 为 1234 的 短信 会 话 记 录 。 如 果 当 前 系统 中 没有 短信 ， 
使 用 在 介绍 广播 的 章节 中 介绍 的 方法 ， 通 过 Eclipse 的 DDMS 界面 中 的 Emulator Control 
来 指定 任意 号 码 发 送 给 模拟 器 ， 如 图 7.3 所 示 。 


2. 短信 数据 库 分 析 


接 下 来 ， 我 们 来 看 看 短信 数据 库 文件 如 何 保存 这 些 短信 信息 。 在 Eclipse 中 切换 到 
DDMS 视图 , 选择 File Explorer 选项 卡 。 找 到 文件 /data/data/com android.providers.telephony/ 
databases/mmssms.db， 如 图 7.4 所 示 。 该 数据 库 文件 则 是 存储 短信 的 数据 库 文件 。 











Messaging 


New message 
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234 (3) 
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图 7.1 短信 应 用 图 7.2 短信 查看 









































betor control © 二 加 
hone 局 ms 避 可 
pepe eee 门 篇 Trewas [四 Mewp | 国 Alloestion Trecker [ 叫 : 器 
Tnconing meber: |1234 | kee Size Date 
Ovoice 出世 co endroid providers drm 2011-11-19 
[GED BB com android previders nedin 2011-11-19 
末世 co endroid providers, settings 2011-11-19 
人 ss FS com sndroid providers, sabseribedfes 2011-11-19 
3 Geom. android providers telephony 2011-11-19 
SG datsbaxes 2011-12-01 
ss db 37888 2011-11-22 
Ea talephony 0 4096 2011-12-01 
二 蕊 li 2011-11-19 
Location Controls 出 全 shared prefs 2011-11-19 





图 7.3 向 模拟 器 发 送 短信 图 7.4 短信 数据 库 文件 





出 该 数据 库 文 件 , 使 用 数据 库 查 看 工具 SQLiteSpy 进行 查看 , 如 图 7.5 和 图 7.6 所 示 。 


Tile Bait View Execute Options Melp 
Name Type | 画图 ws 
= 0 man E:\Andn 

3 凡 Tables (17) 




















theadd address _ person date protocol read status type 
I 1 T1755626 0 工 
1 1234 1321794719367 0 1 
1 1234 1321794773252 0 1 1 
1 1234 1321794785528 0 a 1 1 
1 1234 1321794793860 0 T 于 
1 1234 13217946296817 0 1 1 1 
1 1234 1321794850246 0 1 1 1 
1 1234 1321794691822 0 1 1 1 
1 1234 1321794964520 0 1 1 
1 1234 1321795392413 0 1 1 1 
1 1234 1321795435284 0 1 1 
1 1234 1322748678653 1 1 2 
2 234 1322748906913 0 1 1 
2 234 1322748920176 1 1 2 
2 234 1322748935849 0 1 1 1 


图 7.5 短信 数据 库 文件 
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5 5 5 下 
1 0 test broadcast 0 0 1 
1 0 test broadcast 0 0 1 
1 0 test broadcast 0 0 1 
1 0 test broadcast 0 0 1 
1 0 test broadcast 0 0 1 
1 0 test broadcast 0 0 1 
1 0 test broadcast 0 0 
1 0 test broadcast 0 0 1 
1 0 test static broa 0 0 1 
1 0 test static broa, 0 0 1 
2 Have get 0 0 1 
1 0 send more sms 0 0 1 
2 Helo 0 0 1 
1 0 helo android 0 0 1 


图 7.6 sms 表 ( 续 ) 


由 图 7.5 可 知 ， 数 据 库 中 使 用 了 很 多 张 表 来 存储 这 些 信 息 ， 我 们 需要 关注 的 是 sms 表 。 
通过 图 7.5 和 图 7.6 可 以 很 明显 地 看 出 在 sms 表 中 ， 保 存 了 短信 的 号 码 、 时 间 、 短 信 
内 容 等 信息 。 下 面 ， 我 们 详细 介绍 其 中 我 们 需要 关注 的 项 : 


口 
口 


口 


口 


D:DOe 


_id， 指 定 短 消息 序号 。 作 为 该 表 的 唯一 标识 ， 是 递增 的 序号 。 

thread_id, 会 话 的 序号 。 是 根据 不 同 的 号 码 进行 默认 分 配 的 递增 序号 ， 相 同 号 码 的 
序号 是 相同 的 。 

address， 发 件 人 的 地 址 ， 为 手机 号 。 如 果 是 本 机 发 出 短信 ， 则 该 地 址 为 收 件 人 
号 码 。 

person， 发 件 人 。 该 返回 值 为 数字 ， 是 该 联系 人 在 联系 人 表 中 的 序号 ， 如 果 需 要 获 
取 联 系 人 的 姓名 , 需要 通过 联系 人 表 再 进行 一 次 查询 。 当 为 陌生 人 时 , 该 值 为 null。 
date， 日 期 ， 为 long 型 ， 获 取 的 具体 日 期 需要 自己 进行 转换 。 

protocol, 协议 。 其 中 , 0 表示 SMS_RPOTO 为 短信 ; 1 表示 MMS_PROTO 为 彩信 。 
read， 标 记 是 否 已 阅读 。 其 中 ，0 表示 未 读 ，1 表示 已 读 。 

status， 短 信 状 态 。 其 中 ，-1 表示 已 接收 ，0 表示 已 发 送 ，64 表示 发 送 中 ，128 表 
type， 短 信 类 型 。 其 中 1 表示 是 接收 到 的 短信 ，2 表示 是 发 出 的 短信 。 

subject， 短 信 或 者 彩信 的 主题 。 

body， 短 信 内 容 。 


在 获取 短信 的 时 候 ， 就 是 对 这 张 表 进行 查询 。 在 明白 了 各 列表 示 的 含义 后 ， 我 们 可 以 
比较 容易 地 查询 短信 内 容 。 接 下 来 ， 实 现 对 指定 号 码 短信 的 导出 。 


A 


和 


导出 短信 


功能 说 明 


我 们 通过 输入 号 码 来 指定 导出 短信 。 在 界面 设计 中 ， 只 使 用 号 码 输 入 框 和 导出 短信 按 
钮 即 可 ， 如 图 7.7 所 示 。 另 外 ， 由 于 写 数据 是 一 个 比较 耗 时 的 操作 ， 需 要 开辟 一 个 单独 的 
线程 来 完成 ， 我 们 使 用 异步 任务 来 实现 这 一 过 程 ， 导 出 短信 时 ， 效 果 如 图 7.8 所 示 。 
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中 ET 


图 7.7 导出 短信 界面 图 7.8 正在 导出 界面 


这 样 一 个 过 程 , 我 们 需要 读 取 短 信 的 权限 以 及 在 SD 卡 中 创建 文件 和 写 入 数据 的 权限 ， 


在 AndroidManifest.xml 
<!-- 读 取 短信 的 权限 


<uses-permission 


加 入 读 取 通 讯 录 的 权限 ， 代 码 如 下 : 


一 -> 
android:name="android.permission.READ SMS" /> 


<!-- 在 SD 卡 中 创建 与 删除 文件 权限 --> 





<uses-permission 


android:name="android.permission.MOUNT UNMOUNT FILESYSTEMS"/> 
<!-- 往 SD 卡 写 入 数据 权限 --> 


<uses-permission 


android:name="android.permission.WRITE EXTERNAL STORAGE"/> 


2. 获取 指定 号 码 短信 信息 


查询 短信 数据 库 的 过 程 和 在 数据 存储 章节 中 获取 联系 人 信息 的 方法 类 似 ， 首 先 我 们 需 


要 指定 查询 的 URI 地 址 ， 


分 别 定义 如 下 : 


final String SMS URI ALL = "content://sms/"; // 所 有 短信 
final String SMS URI INBOX = "content://sms/inbox";  ”// 收 件 箱 短信 
final String SMS URI SEND = "content://sms/sent"; // 发 件 箱 短信 


final String SMS URI DRAFT = "content://sms/draft"; // 草 稿 箱 短信 


在 短信 数据 库 中 sms 表 中 的 信息 非常 丰富 ， 我 们 只 需要 获取 需要 的 短信 编号 、 发 件 人 
号 码 、 发 件 人 名 字 、 短 信 内 容 、 时 间 和 短信 类 型 即 可 。 所 以 ， 我 们 构造 查询 的 结果 数组 


如 下 : 


string[] projection = new String[] { ”id"， 


", "address", "person","body", 


"date", "type" }; 

















于 我 们 只 需要 导 贡 











指定 号 码 的 短信 ， 所 以 在 查询 sms 表 时 ， 查 询 的 条 件 就 是 发 件 人 
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号 码 与 输入 的 号 码 匹 配 ， 实 现 如 下 : 


Cursor cur 
null, 


= cr.query (uri, projection, "address like '%" + number + ™'", 
"date desc"); 


熟悉 了 查询 短信 数据 库 的 过 程 以 及 需要 注意 的 重点 ， 具 体 的 完整 实现 如 下 : 


01 
02 
03 
04 


final String SMS URI ALL = "content://sms/";  // 系 统 短信 数据 库 URI 
private String get sms(String number) { 


StringBuilder sms Builder = new StringBuilder(); 
// 查 询 短信 数据 库 
ContentResolver cr = getContentResolver (); 
String[] projection =new String[] {" id", "address", "person", 
"body", "date", "type" }; 
Uri uri = Uri.parse (SMS URI ALL); 
Cursor cur = cr.query (uri, projection, "address like '%" + number 
+ "null, "date dsoe").s 
// 查 询 获取 指定 号 码 的 所 有 短信 
if (cur.moveToFirst()) { // 判 断 是 否 有 结果 
String name; 
String phoneNumber; 
String smsbody; 
String date; 
String type; 


do { // 裔 历 查 询 结果 


name = cur.getSstring (2); // 获 取 姓 名 
PhoneNumber = cur.getString (1); // 获 取 电 话 号 码 
smsbody = cur.getString (3); // 获 取 短信 内 容 
if (smsbody == null) 

smsbody = ""; 


SimpleDateFormat dateFormat = new SimpleDateFormat 
("yyYYY-MM-dd hh:mm:ss"); 
Date d = new Date (Long.ParseLong (cur.getString(4))); 


// 获 取 时 间 
date = dateFormat.format (d); // 设 置 时 间 格 式 
int typeId = cur.getInt(5); // 获 取 类 型 
if (typeId == 1) { // 接 收 到 短信 
type = "接收 "; 
} else if (typeId = 2) { // 发 出 短信 
type = "发 送 "; 
} else { // 草 稿 


type = "草稿 "; 
} 


sms Builder.append (name + ","); 

sms Builder.append (phoneNumber + ","); 
sms_Builder.append (smsbody + ","); 
sms_ Builder.append(date + ","); 

sms Builder.append (type); 

sms Builder.append("\n"); 


} while (cur.moveToNext()); 
} else { 
sms_ Builder.append("no result!"); // 无 查询 结果 
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47 
48 
49 
50 } 


其 中 ，01 行 ， 


} 
cur.close(); 
return sms Builder.toString(); 


指定 了 查询 短信 的 范围 ， 为 手机 中 所 有 的 短信 ; 


05 一 08 行 ， 对 短信 数据 库 中 指定 号 码 的 查询 。 该 过 程 是 获取 短信 的 重点 ， 在 数据 库存 
储 、 数 据 共享 和 系统 通讯 录 章 节 中 有 这 一 过 程 更 加 详细 的 介绍 ; 

17 一 22 行 , 遍历 查询 结果 ,获取 结果 中 短信 的 发 件 人 名 字 编 号 、 发 件 人 人 号码、 短信 内 容 ; 

24 一 26 行 ， 获 取 短信 时 间 ， 并 将 long 型 转 为 标准 时 间 “ 年 月 日 、 时 分 秒 ”格式 ; 

28 一 35 行 ， 获 取 短信 类 型 ， 并 根据 类 型 编号 转 为 文字 表示 ; 

37 一 42 行 ， 将 获得 的 查询 结果 全 部 添加 到 sms_Builder 中 ， 最 后 返回 该 值 。 


3. 写 入 文本 











获取 了 指定 号 码 的 短信 内 容 后 ， 将 获取 的 内 容 以 文本 形式 保存 到 SD 卡 中 。 我 们 首先 
需要 判断 SD 卡 是 否 可 用 ， 如 果 SD 卡 可 用 则 在 SD 卡 中 创建 文件 并 将 内 容 写 入 该 文件 中 。 


这 个 在 SD 卡 写 入 数据 的 过 程 ， 在 数据 存储 章节 中 进行 了 详细 的 介绍 。 本 实例 中 ， 具 体 实 
现 如 下 : 
01 private boolean file writel(String filename, String content) { 
02 // 判 断 SD 卡 是 否 可 用 
03 if (!android.os.Environment.getExternalStorageState () . 
equals ( 
04 android.os.Environment.MEDIA MOUNTED)) { 
05 return false; 
06 } 
07 String filepath = Environment.getExternalStorageDirectory() . 
getAbsolutePath () 
08 + "/" + filename; // 保 存 文件 名 
09 File file = new File(filepath); // 创 建文 件 类 
10 Te 
rl if (!file.exists()) { // 判 断 文 件 是 否 存 在 
于 file.createNewFile(); // 不 存在 则 新 建文 件 
| 下 
14 FileOutputStream fos = new FileOutputStream(file, true); 
// 获 取 文 件 输出 流 
15 fos .write (content .getBytes()); // 写 入 文件 
16 fos.close(); 
站 } catch (Exception e) { 
18 Log.i(TAG, "file write w " + e.tostring()); 
9 return false; 
20 } 
21 return true; 
22 } 


其 中 ，03 一 06 行 ， 判 断 SD 卡 是 否 可 用 ， 如 果 不 可 用 则 返回 失败 ; 
07 一 13 行 ， 新 建 保存 短信 的 文件 ; 
14 一 16 行 ， 将 内 容 以 追加 的 方式 添加 到 文件 中 。 


4. 异步 任务 








为 了 提供 更 友好 的 用 户 交 互 界面 ， 我 们 在 导出 短信 的 同时 ， 在 界面 上 提示 等 待 信息 ， 
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如 图 7.8 所 示 。 使 
函数 来 实现 UI 








异步 任务 来 实现 这 一 过 程 。 我 们 需要 重 写 AsyncTask 中 的 onPreExecute() 
的 显示 ; doInBackground0) 函数 来 实现 后 台 执 行 的 短信 导出 过 程 ; 





onPostExecute() 函 数 来 实现 导出 短信 完成 后 ， 在 界面 中 给 出 的 提示 信息 。 在 应 用 程序 特性 
一 章 中 的 消息 处 理 部 分 有 更 详细 的 介绍 。 在 本 实例 中 ， 具 体 实现 如 下 : 





01 new AsyncTask<Integer, Integer, String>() { 
02 private ProgressDialog dialog; 
03 
04 //UI 显示 
05 Protected void onPreExecute() { 
06 dialog = ProgressDialog.show (Ex ExportSMSActivity.this, 
"", "正在 导出 短信 , 请 稍 候 . . - .") ; 
07 super.onPreExecute () ; // 界 面 显示 进度 条 
08 } 
09 
10 // 后 台 执 行 
本 Protected String doInBackground(Integer... params) { 
h String input number = edt number.getText () .toString(); 
// 获 取 输 入 号 码 
13 String result = ""; 
14 // 导出 指定 号 码 的 短信 
15 if (file writel(input number + ".txt",get sms(input 
number))) { // 调 用 写 短 信 方 法 
16 result = "号 码 " + input number + "的 所 有 短信 已 经 导出 
到 文件 " 
17 + input number + ".txt 中 "7 
18 } else { 
19 result = "号 码 " + input_number + "的 所 有 短信 导出 到 文 
件 失败 "; 
20 } 
2 } 
必 交 return result; 
| . 
24 
25 // 搜 索 完 毕 后 ， 结 果 处 理 
26 protected void onPostExecute (String result) { 
2 dialog.dismiss(); // 进 度 条 消失 
28 new AlertDialog.Builder (Ex ExportSMSActivity.this) 
29 -SetMessage (result) .create () . 
show() 7 // 显 示 完 成 提示 框 
30 Super .onPostExecute (result) 
3 } 
号 及 } .execute (0) 





其 中 ，05 一 08 行 ， 重 写 onPreExecute0 函 数 ， 实 现 了 显示 正在 导出 的 进度 条 ; 


10 一 23 行 ， 邓 


的 过 程 ， 返 回 的 结果 为 是 否 导出 成 功 的 信息 ; 





和 E 写 doInBackground() 函 数 ， 实 现 了 后 台 运 行将 指定 号 码 的 短信 导出 文本 








25 一 31 行 ， 重 写 onPostExecute() 函 数 ， 实 现 了 显示 返回 结果 的 提示 框 ， 效 果 如 图 7.9 


所 示 。 


5. 导出 所 有 短信 


除了 对 指定 号 码 需 要 导出 以 外 ， 我 们 有 时 也 需要 将 手机 中 的 所 有 短信 导出 到 文本 中 。 
在 前 面 已 经 实现 的 指定 号 码 短 信和 导出 的 基础 上 ， 我 们 只 需要 获取 短信 的 所 有 号 码 即 可 。 
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CE 


的 所 有 | 
文件 AINumber.txt 中 





图 7.9 完成 导出 所 有 短信 


由 于 SQLite 不 支持 SQL 语句 中 的 DISTINCT 关键 字 ， 不 能 直接 通过 选择 查询 来 获取 
所 有 的 号 码 ， 我 们 通过 将 号 码 排序 后 ， 获 取 其 中 不 同 的 号 码 ， 关 键 代码 实现 如 下 : 


01 cur = cr.query (uri, projection, null, null, "address desc"); 


// 查 询 所 有 短信 ， 按 照 号 码 排序 


02 if (cur.moveToFirst()) { 

03 do { 

04 // 保 存 所 有 号 码 

05 String tmpString = cur.getString(1);  // 获 取 当 前 号 码 

06 if (!address.equals (tmpString) ) { // 判 断 上 一 号 是 否 与 当前 号 相同 
07 address = tmpstring; // 不 同时 ， 保 存 该 号 到 号 人 码 列表 中 
08 list.add (tmpString); 

09 } 

10 } while (cur.moveToNext()); 

生生 | 

其 中 ，01 行 ， 查 询 所 有 短信 ， 并 按照 号 

05 一 09 行 , 遍历 查询 的 结果 , 当 发 现 当 前 号 码 与 上 一 个 号 码 不 同时 , 将 号 码 保存 到 list 


中 。 最 后 返回 该 list， 则 保存 了 所 有 的 号 码 。 
在 异步 任务 时 ， 添 加 对 输入 的 判断 ， 当 输入 为 空 时 ， 则 导出 所 有 的 短信 。 实 现 如 下 : 


01 // 导 出 所 有 短信 

02 if (input number.equals("")) { // 判 断 输入 号 码 是 否 为 空 

03 List<String> listnumber = getAllNumber() ; // 获 取 全 部 号 码 

04 for (String number : Listnumber) {// 遍 历 号 码 列表 ， 逐 号 获取 短信 

05 if (file write("AllNumber.txt", get sms(number))) { 

06 result += "号 码 ”+ number+ "的 所 有 短信 已 经 导出 到 文件 
AllNumber.txt 中 \n"; 

07 } else { 

08 result += "号 码 " + number + "的 所 有 短信 和 导出 到 文件 失败 \n"; 

09 } 

10 } 

1 } 
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其 中 ，02 行 ， 判 断 输入 是 否 为 室 ， 当 为 空 时 导出 全 部 短信 ; 03 行 ， 调 用 获取 全 部 号 
码 函 数 ， 获 取 所 有 号 码 ; 04 一 10 行 ， 遍历 获取 的 所 有 号 码 ， 分 别 导出 每 一 个 号 码 的 短信 ， 
输出 到 文件 AllNumbertxt 中 ， 效 果 如 图 7.9 所 示 。 


7.1.3 分析 总 结 


通过 上 面 的 步骤， 我 们 实现 了 将 手机 中 的 短信 和 导出 到 文本 中 。 对 所 有 短信 和 导出 功能 进 
行 测试 ， 成 功 导 出 文本 文件 到 SD 卡 中 ， 如 图 7.10 所 示 。 


BDBmt 2011-12-01 
由 世 asec 2011-12-01 
日 已 sdcard 2011-12-01 






BS 1318936597201. jpz 






由 GC DCIN 


是 Justin Bieber-Baby. np3 1735679 2011-08-30 
由 世 LOST.IDTR 2010-10-10 
address. xml 192 2011-08-31 


图 7.10 短信 导出 文件 


将 该 文件 保存 到 PC 机 中 ， 打 开 查 看 文本 结果 如 图 7.11 所 示 。 与 使 用 系统 中 自 带 的 名 
为 Messaging 的 短信 程序 查看 的 内 容 〈 如 图 7.2 所 示 ) 进行 比较 ， 可 以 发 现 内 容 是 一 致 的 ， 
我 们 导出 的 短信 是 完全 正确 的 。 
ERTRTTTRRRURITTRREUJRRTTFREUFFTFTRCORTTRRREURFTTF 


1hull.234.hello Android.2811-12-91 19:15:35. 接 收 

2 null.234,Hello.2811-12-81 16:15:28, 发 送 

3 null.234,send more sns,2811-12-81 19:15:98. 接 收 

4 null.1234.Have get.2811-12-81 19:14:38. 发 送 

5 null,1234,test static broadcast-2911-11-29 89:23:55. 接 收 
6 null.1234.test static broadcast-2911-11-29 99:23:12. 接 收 
7 null,1234,test broadcast,2011-11-28 89:16:| 

8 null,1234,test broadcast,2811-11-28 @9: 
9 null,1234,test broadcast-2811-11-28 89:: 
10 null,1234,test broadcast.2811-11-28 89:13:49, 接 收 
11 null,1234,test broadcast,2811-11-28 89:13:13, 接 收 


图 7.11 导出 文本 结果 





7.2 短信 收发 软件 


对 于 手机 短信 软件 ， 最 基本 应 该 实现 的 功能 则 是 接收 和 发 送 短信 。 在 这 一 节 中 ， 我 们 
将 使 用 实例 详细 介绍 接收 和 发 送 短信 的 功能 。 


7.2.1 短信 防火 墙 
我 们 每 天 都 会 收 到 各 种 各 样 的 垃圾 短信 ， 短 信 防 火 墙 是 短信 软件 非常 常见 的 功能 ， 接 
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下 来 我 们 就 在 接收 短信 中 实现 这 样 的 功能 。 
1. 功能 说 明 


我 们 知道 在 Android 系统 中 ， 存 在 很 多 系统 广播 。 当 手机 接收 到 短信 时 ， 就 是 使 用 / 
播 的 方式 来 通知 所 有 的 应 用 程序 的 。 而 且 ， 短 信 广 播 是 一 个 有 序 的 广播 ， 一 次 传递 给 一 个 
广播 接收 器 ， 当 该 接收 器 处 理 完成 后 才 会 传递 给 下 一 个 接收 器 。 这 样 ， 我 们 就 可 以 通过 在 
系统 短信 程序 接收 到 短信 广播 之 前 终止 该 短信 广播 ， 便 可 实现 短信 防火 墙 。 接 下 来 ， 我 们 
详细 介绍 这 一 实现 过 程 。 

要 获取 短信 广播 , 需要 相应 的 权限 。 在 AndroidManifestxml 中 加 入 该 权限 , 代码 如 下 : 

<uses-permission android:name="android.permission.RECEIVE SMS" /> 

2. 短信 内 容 解析 

对 于 是 否 是 垃圾 短信 ， 我 们 采用 最 基本 的 短信 号 码 黑 名 单 进行 判断 。 当 短信 和 号码 在 黑 
名 单 中 则 屏蔽 该 短信 ， 达 到 防火 墙 的 目的 。 我 们 必须 从 短信 广播 中 获得 短信 的 号 码 。 

在 Android 设备 中 ， 接 收 到 的 SMS 是 以 pdu(protocol description unit) 协 议 的 编码 形式 
来 进行 传递 的 。 在 短信 广播 Intent 中 可 以 获取 pdu 数组 ， 实 现 如 下 : 


Bundle bundle = intent.getExtras () 7 
Object[] object = (Object[]) bundle.get ("pdus"); 


当然 Android 也 提供 了 更 加 容易 理解 的 SmsMessage 类 来 管理 获取 的 短信 。 从 pdu 数 
组 中 转换 为 SmsMessage 类 ， 直 接 使 用 方法 为 : 

SmsMessage createFromPdu (byte[] pdu) 

这 样 , 就 获得 了 当前 短信 的 SmsMessage 类 。 在 SmsMessage 中 包含 了 短信 消息 的 详细 
信息 ， 包 括 起 始 地 址 (电话 号 码 )、 时 间 、 消 息 体 。 分 别 使 用 获取 的 方法 如 下 : 























String getMessageBody () // 获 取 SMS 消息 体 
String getOriginatingaddress () // 获 取 起 始 地 址 
long getTimestampMillis() // 获 取 时 间 


熟悉 了 从 短信 广播 中 解析 获取 短信 的 详细 信息 的 方法 。 我 们 在 接收 广播 中 显示 获取 短 
信 信 息 ， 并 对 指定 的 号 码 进 行 禁止 广播 ， 具 体 实现 如 下 : 


la public void onReceive (Context context, Intent intent) { 
02 String action = intent.getAction(); 
03 if (action.equals (Ex SMSActivity.SMS RECEIVER)) { // 判 断 动作 
04 Bundle bundle = intent.getExtras(); // 获 取 携 带 的 数据 
05 if (bundle != null) { 
06 Object[] object = (Object[]) bundle.get("pdus"); 
// 获 取 pdus 原始 数据 
07 SmsMessage[] messages = new SmsMessage[object.1length]; 
// 实 例 化 短信 类 
08 for (int i = 0; i < object.length; i++) { 
// 原 始 数 据 转换 为 短信 类 数据 
09 messages[i] = SmsMessage.createFromPdul( (byte[]) 
object[i]); 
10 } 
11 SmsMessage message = messages[0]; // 重 组 短信 信息 类 
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25 } 


Toast .makeText (context, 
"接收 到 消息 的 号 码 是 : " + message.getDisplay- 
OriginatingAddress () 
+"\n 接收 到 的 消息 是 "+ message - 
getMessageBody(), 1000) 
-show (); // 提 示 获 取 的 短信 信息 
Log.i (Ex _SMSActivity.TAG, "接收 到 消息 的 号 码 是 : " 
+ message.getDisplayOriginatingAddress() + ", 
接收 到 的 消息 是 " 
+ message.getMessageBody() ) ;// 打 印 短信 信息 
if (message.getDisplayOriginatingAddress(). 
equals ("5556")) { // 判 断 短信 发 送 号 码 
abortBroadcast () : // 终 止 广播 ， 实 现 短信 拦截 
Log-i(Ex_SMSRctivity.TAG，" 终 止 了 短信 广播 ") ; 
} 


其 中 ，03 行 ， 通 过 动作 判断 接收 到 的 广播 是 否 为 短信 广播 ; 
04 一 11 行 ， 从 短信 广播 中 获取 pdu 数据 并 转 为 SmsMessage 类 ; 


12 一 18 行 ， 


显示 获取 的 短信 号 码 以 及 短信 内 容 ; 


19 一 22 行 ， 通 过 短信 和 号码 进行 拦截 。 如 果 短 信和 号 码 为 5556， 则 禁止 该 短信 广播 。 这 
样 系统 短信 程序 将 接收 不 到 该 广播 ， 不 会 提示 有 新 短信 ， 达 到 短信 防火 墙 的 目的 。 


3. 广播 注册 


要 达到 在 系统 短信 程序 前 处 理 短信 广播 ， 优 先 级 必须 比 系统 短信 程序 更 高 。 我 们 在 
AndroidManifest.xml 文件 中 ， 静 态 注册 广播 ， 并 赋予 最 高 优先 级 ， 实 现 如 下 : 


<receiver android:name=".SMS receiver" > 
<intent-filter android:priority="10000" > 
<action android:name="android.pProvider.Telephony.-SMS 


RECEIVED" /> 


</intent-filter> 


</receiver> 


4. 运行 分 析 


通过 上 面 3 步 ， 我 们 实现 了 对 所 有 短信 的 信息 提示 ， 并 对 5556 号 码 的 短信 进行 屏蔽 ， 
不 会 在 系统 短信 程序 中 看 到 。 我们 通过 Eclipse 的 DDMS 界面 中 的 Emulator Control 来 给 模 
拟 器 发 送 短信 。 我 们 分 别 使 用 5556 的 号 码 和 5557 的 号 码 来 给 模拟 器 发 送 短信 ， 测 试 是 否 
能 够 获取 短信 信息 和 在 系统 短信 程序 中 屏蔽 ， 测 试 效果 分 别 如 图 7.12 和 图 7.13 


所 示 。 


从 图 7.12 中 可 以 看 出 ， 获 取 了 来 自 5556 的 短信 ， 当 提示 结束 后 不 再 有 其 他 变化 。 当 
使 用 5557 发 送 相同 内 容 的 短信 后 , 在 短信 内 容 提 示 信 息 后 , 在 最 上 方 的 状态 提示 栏 中 出 现 
了 系统 短信 程序 的 提示 信息 ， 如 图 7.13 所 示 。 在 调试 信息 中 ， 我 们 同样 可 以 通过 输出 信息 





看 出 它们 的 不 同 


火 墙 的 功能 。 
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， 如 图 7.14 所 示 。 说 明 我 们 实现 了 对 5556 的 短信 的 屏蔽 ， 实 现 了 短信 防 
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图 7.13 其 他 号 码 


Tag Text 
EXSNS 接收 到 冰 息 的 号 码 是 : 5556， 搁 收 到 的 消 息 是 hello receiver sns 
EXSHS 终止 了 短信 广播 

了 XSHS 后 收 到 消息 的 号 码 是 : 5557， 氨 收 到 的 消息 是 hello receiver sms 


图 7.14 调试 信息 


7.2.2 系统 发 送 短信 


我 们 实现 了 接收 短信 ， 接 下 来 实现 与 之 相对 的 发 送 57FZI 


短信 功能 。 由 于 Android 系统 中 都 有 默认 的 短信 程序 ， -amerc] 


我 们 可 以 使 用 系统 的 短信 程序 来 实现 发 送 短信 的 功能 ， 
当然 也 可 以 直接 发 送 短信 。 接 下 来 ， 我 们 使 用 系统 的 短 | 
信 程序 来 发 送 短信 。 

1. 界面 设计 

发 送 短信 时 ， 我 们 需要 输入 发 送 到 的 号 码 以 及 短信 
内 容 。 所 以 在 界面 中 ， 我 们 只 需要 两 个 输入 框 和 发 送 按 
钮 即 可 ， 如 图 7.15 所 示 。 

2， 跳 转 实现 











我 们 只 需要 将 输入 的 号 码 和 短信 内 容 封 装 到 Intent 
中 ， 并 使 用 该 Intent 跳 转 到 系统 短信 程序 中 。 具 体 实现 图 7.15 短信 发 送 界面 
如 下 : 
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01 private void sendSysSMS (String phone num, String message) { 


02 Phone num = "smsto:" + phone num; // 在 号 码 前 必须 加 smsto: 

03 Intent sys send intent = new Intent( 

04 android.content.Intent.ACTION SENDTO, Uri.parse 
(Phone num)); 

05 sys_send intent.putExtra("sms body"，message) ; // 添 加 短信 内 容 

06 startRctivity(sys_send intent) // 跳 转 到 系统 发 送 界 面 

07 


其 中 ，02 行 ， 指 定 短信 发 送 到 的 号 码 。 需 要 注意 的 是 必须 在 号 码 前 添加 smsto:; 
03 一 04 行 ， 实 现 一 个 发 送 短信 的 Intent。 其 中 动作 ”Ps 
是 android.content.Intent. ACTION_ SENDTO; 
05 行 ,将 短信 的 内 容 作 为 附加 数据 添加 到 Intent 中 。 
其 中 名 为 sms_body; 2 
06 行 ， 跳 转 实现 。 实 现 界 面 跳 转 ， 跳 转 到 系统 短信 
程序 ， 并 且 已 经 完成 填写 号 码 和 短信 内 容 ， 只 需要 单 击 
Send 按钮 即 可 发 送 短信 ， 效 果 如 图 7.16 所 示 。 


3， 双 模拟 器 调试 


对 于 这 样 的 短信 发 送 程序 ， 单 个 模拟 器 已 经 不 能 直 
观 地 看 出 短信 是 否 发 送 成 功 ， 需 要 再 启动 另 一 个 模拟 
器 。 在 Eclipse 标题 栏 中 单 击 “ 打 开 Android 模拟 设备 管 图 
理 器 ”图 标 ， 在 提示 框 中 ， 选 择 需要 启动 的 模拟 器 。 选 
择 的 模拟 器 可 以 和 已 经 启动 的 模拟 器 是 同一 个 , 会 再 启 。” ”图 7.16 跳 续 到 系统 短信 程序 
动 另 一 个 模拟 器 设备 ， 实 现 过程 如 图 7.17 所 示 。 





Help 


让 B[a | Sneadi#-O- Wi 由 OF i 





Tn 
List of existing Andro: Devices located at D:\Docunents and Settings\Dwner\, android\avd 
AVD Name Platform API Level CPU/ABI 








图 7.17 启动 另 一 个 模拟 器 


当 模 拟 器 启动 后 ， 我 们 可 以 发 现 两 个 模拟 器 在 左上 方 标题 中 很 明显 的 区 别 : 一 个 模拟 
器 是 5554、 另 一 个 是 5556， 如 图 7.18 所 示 ， 这 个 号 码 则 是 我 们 短信 发 送 到 的 号 码 。 我 们 
实现 发 送 短信 的 模拟 器 是 左 图 的 5554 模拟 器 , 单 击 Send 按钮 后 , 在 右 图 中 的 5556 模拟 器 
中 便 接收 到 该 短信 。 
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7.2.3 直接 发 送 短信 


我 们 已 经 实现 了 通过 系统 短信 程序 来 发 送 短信 的 功能 


， 接 下 来 我 们 不 通过 系统 短信 程 
序 来 直接 发 送 短信 。 
1. 界面 设计 


在 界面 设计 中 , 和 使 用 系统 短信 程序 发 送 是 一 样 的 
接 发 送 短信 ”的 按钮 即 可 ， 效 果 如 图 7.19 所 示 。 
66545231 


， 只 需要 在 之 前 界面 中 添加 一 个 “ 直 


mr 


Eacga 咱 Emmaemcra 
5556 


Android [gear | ED 


Notifications 


归 15555215554 2 
hello 5556 





hello 5556 send| 


使 用 系统 发 送 短信 


直接 短信 发 送 


二 Me: hello 5556 


nt: 16:22 





图 7.18 系统 发 送 短信 图 7.19 直接 发 送 短信 界面 


要 直接 发 送 短信 ， 需 要 申请 相应 的 权限 。 在 AndroidManifest.xml 中 加 入 该 权限 ， 代 码 
如 下 : 


<uses-permission android:name="android.permission.SEND SMS" /> 

2. 发 送 短信 

Android 系统 为 了 方便 发 送 短信 ， 提 供 了 一 个 短信 管理 类 SmsManager， 我 们 使 用 这 个 
类 可 以 很 方便 地 发 送 短信 。 

(1) SmsManager 类 


SmsManager 类 中 的 方法 比较 少 ， 当 然 足够 我 们 完成 发 送 短信 的 功能 。 主 要 的 方法 
如 下 : 


static SmsManager getDefault() 








于 获取 SmsManager 的 默认 实例 。 其 中 ， 返 回 值 为 默认 实例 。 
于 每 一 条 短信 的 长 度 是 有 限制 的 ， 当 超过 限制 时 ， 我 们 需要 分 割 短 信 ， 使 用 方法 




















如 下 : 


ArrayList<String> divideMessage (String text) 
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当 短 信 超 过 SMS 消息 的 最 大 长 度 时 ， 将 短信 分 割 为 儿 块 。 其 中 ， 参 数 text 是 初始 的 
消息 ， 





不 能 为 空 。 返 回 值 为 有 序 的 ArrayList<String>， 可 以 重新 组 合 为 初始 的 消息 。 


准备 好 可 以 发 送 的 短信 内 容 后 ， 就 可 以 进行 短信 发 送 ， 使 用 方法 如 下 : 


void sendTextMessage (String destinationAddress, String scAddress, 
String text, PendingIntent sentIntent, PendingIntent deliveryIntent) 











DOOO 





于 发 送 文 本 的 短信 ， 其 中 各 个 参数 都 很 重要 : 

destinationAddress， 表 示 消 息 的 目标 地 址 。 

scAddress， 表 示 服 务 中 心 的 地 址 。 如 果 为 空 ， 则 使 用 当前 默认 的 服务 中 心地 址 。 
text， 表 示 消 息 的 主体 ， 即 要 发 送 的 内 容 。 

sentIntent， 发 送 完 成 后 的 处 理 。 如 果 此 值 不 为 空 ， 则 当 消 息 发 送 成 功 或 失败 后 ， 
该 PendingIntent 就 被 广播 。 广 播 中 的 结果 代码 分 别 是 : 

> ActivityRESULT_OK 表示 成 功 ; 

> RESULT_ ERROR GENERIC FAILURE 表示 普通 错误 ; 

> RESULT _ ERROR RADIO_OFF 表示 无 线 广 播 被 关闭 ; 

> RESULT ERROR _NULL PDU 表示 pdu 错误 。 


口 deliveryIntent， 如 果 不 为 空 ， 当 消息 成 功 传送 到 接收 者 这 个 PendingIntent 就 广播 。 


通常 用 于 短信 回执 。 


其 中 ， 参 数 destinationAddress 和 text 不 能 为 空 ， 不 然 会 发 送 异 常 。 


从 SmsManager 的 方法 中 可 以 看 出 ， 发 送 短信 比较 简单 ， 关 键 在 于 sentIntent 和 
deliveryIntent 的 实现 。 接 下 来 ， 我 们 分 别 实现 这 两 种 PendingIntent。 

(2) sentIntent 实现 

PendingIntent 类 相当 于 一 个 延迟 异步 的 广播 ， 当 有 事件 触发 时 则 发 送 广播 。 获 取 
PendingIntent 实例 的 方法 如 下 : 

PendingIntent getBroadcast(Context context, int requestCode, Intent 

intent, int flags) 

其 中 ，requestCode 是 发 送 者 发 送 的 请 求 编 号 ;intent 是 被 发 送 的 广播 意图 。 

我 们 需要 实现 的 是 ， 当 该 广播 Intent 被 发 送 后 ， 获 取 该 广播 并 根据 请 求 编号 给 出 相应 
的 提示 信息 。 具 体 实现 如 下 : 


01 private static final String SENT SMS ACTION = "SENT SMS ACTION"; 
// 定 义 短信 发 送 动作 

02 Private static final String DELIVERED SMS ACTION = "DELIVERFED 
SMS_RCTION";// 定 义 发 送 成 功 

03 // 发 送 设 置 

04 Intent sentIntent = new Intent (SENT SMS ACTION);  // 发 送 意 图 

05 PendingIntent sent pi = PendingIntent.getBroadcast (this, 0, 
sentIntent, 0); 

06 registerReceiver (new BroadcastReceiver() { // 注 册 广 播 

07 QOverride 

08 public void onReceive (Context context, Intent intent) { 

09 switch (getResultCode()) { 

10 case Activity.RESULT OK: // 发 送 成 功 时 

这 下 Toast .makeText (getBaseContext () wsSUcCccessli 2000). 

show (); 
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2 
13 


14 
15 
16 
18 
19 
20 
之 二 
之 公 


23 
24 
29, 
26 
之 
28 
29 


break; 
case SmsManager.RESULT ERROR GENERIC FAILURE: 
// 发 送 短信 时 出 现 一 般 错 误 
Toast .makeText (getBaseContext (), "generic failure", 
Toast .LENGTH SHORT) .show(); 
break; 
case SmsManager.RESULT ERROR RADIO OFF: // 发 送 短信 时 无 信号 
Toast .makeText (getBaseContext (), "SMS radio failure", 
Toast .LENGTH SHORT) .show(); 
break; 
case SmsManager .RESULT ERROR NULL PDU:// 发 送 的 短信 是 错误 编码 
Toast .makeText (getBaseContext (), "SMS null PDU 
failure", 
1000) .show (); 
break; 
default: 
break; 


1 


}, new IntentFilter (SENT_SMS_ ACTION)); 


其 中 ，04 一 05 行 ， 实 例 化 一 个 PendingIntent， 发 送 sentIntent 意图 ; 
06 一 29 行 ， 注 册 广 播 接收 者 。 该 广播 接收 者 用 于 接收 发 送 的 广播 ， 并 根据 不 同 的 编码 


给 出 相应 的 提示 信息 。 


(3) deliveryIntent 实现 
deliveryIntent 的 实现 和 sentIntent 实现 类 似 , 只 是 触发 条 件 是 对 方 已 经 收 到 短信 才 广 播 
意图 Intent。 在 广播 接收 者 中 ， 也 只 需要 提示 收 到 短信 即 可 。 实 现 较 为 简单 ， 具 体 代码 


如 下 : 


Intent deliverIntent = new Intent (DELIVERED SMS ACTION); 
PendingIntent deliver pi = PendingIntent.getBroadcast (this, 0, 
deliverIntent, 0); 
registerReceiver (new BroadcastReceiver() { 

@Override 

public void onReceive (Context context, Intent intent) { 


Toast .makeText (getBaseContext (), "SMS delivered actions", 
Toast .LENGTH SHORT) .show(); 


}, new IntentFilter (DELIVERED SMS ACTION)); 


其 中 ，01 一 02 行 ， 实 例 化 一 个 PendingIntent， 发 送 deliveryIntent 意图 ; 

03 一 09 行 ， 注 册 广 播 接收 者 。 该 广播 接收 者 用 于 提示 对 方 已 经 收 到 短信 。 

(4) 发 送 短信 实现 

熟悉 了 以 上 的 方法 和 PendingIntent 的 实现 这 些 重点 , 在 具体 的 短信 发 送 中 还 需要 注意 
短信 字数 的 限制 。 本 实例 中 ， 具 体 实现 如 下 : 


01 
02 
03 
04 
05 


06 
07 


private void sendSmS (String ph num, String message) { 
SmsManager sms = SmsManager.getDefault(); // 获 取 短 信 管理 类 
// 一 条 短信 的 最 大 长 度 为 70 个 中 文字 符 
if (message.length() > 70) { // 判 断 短 信 文 字 长 度 


ArrayList<String> msgs = sms.divideMessage (message); 
// 长 于 要 求 时 ， 分 隔 短信 
for (String msg : msgs) { 
sms.sendTextMessage (ph num, null, msg, sent pi, 


deliver pi); // 发 送 短信 


"ls 


实战 Android 应 用 开发 








08 

09 } else { 

10 sms .sendTextMessage (ph num, null, message, sent pi, deliver pi); 
// 发 送 短信 

EL } 

下 有 


其 中 ，02 行 ， 获 取 默 认 短 信 管 理 类 SmsManager; 
04 行 ， 判 断 输 入 的 文字 长 度 ， 当 多 于 70 字 时 分 为 多 条 发 送 ; 
05 行 ， 使 用 SmsManager 类 分 隔 短信 ， 使 其 符合 每 条 短信 的 要 求 ; 





07 行 ， 发 送 短信 。 发 送 完 成 后 触发 sent_ pi， 对 方 接收 后 触发 deliver pi。 


3. 运行 分 析 比 较 


完成 代码 后 ， 我 们 在 刚才 的 两 个 模拟 器 间 进 行 测试 。 单 击 “ 直 接 发 送 短信 ”按钮 后 ， 








效果 如 图 7.20 所 示 。 其 中 ， 右 边 模 拟 器 5554 直接 发 送 短信 后 ， 出 现 提示 
左边 模拟 器 5556 接收 到 短信 后 ， 在 状态 提示 栏 也 给 出 了 提示 。 


信 





息 success!; 


但 是 ， 我 们 发 现 一 个 问题 : 在 模拟 器 中 ， 当 5554 成 功 发 送 短信 到 5556 后 ，5554 并 没 
有 给 出 对 方 接收 到 短信 的 提示 信息 。 这 是 由 于 使 用 模拟 器 的 原因 ， 在 真 机 中 可 以 看 到 对 方 


接收 到 短信 的 提示 ， 如 图 7.21 所 示 。 


网 15555215554: hello 5556 send = 


hello 5556 send| 
便 用 系统 短信 发 送 





使 用 系统 短信 发 送 


ET 


图 7.20 直接 发 送 短信 图 7.21 
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SMS dellvered actlons 


真 机 测试 


我 们 分 别 使 用 系统 短信 程序 和 直接 发 送 短信 的 方式 实现 了 发 送 短 信 的 功能 。 在 实现 过 
程 中 ， 有 一 个 很 明显 的 区 别 就 是 使 用 系统 短信 程序 不 需要 申请 权限 ， 而 直接 发 送 必须 申请 
权限 ， 而 在 实现 后 的 效果 上 也 有 所 不 同 。 我 们 分 别 查 看 模拟 器 5554 和 模拟 器 5556 中 短信 





程序 的 记录 结果 ， 如 图 7.22 所 示 。 

















从 图 7.22 中 ， 我 们 可 以 看 出 短信 发 送 模拟 器 5554 中 只 有 使 用 系统 发 送 的 短信 hello 








5556; 而 短信 接收 模拟 器 5556 中 , 除了 系统 短信 程序 发 送 的 短信 外 还 有 使 








直接 发 送 的 短 


信 。 可 以 看 出 , 直接 只 用 SmsManager 发 送 的 短信 没有 写 入 系统 短信 数据 库 中 而 留 下 记录 ， 


所 以 直接 发 送 的 方式 又 称 为 后 台 静 默 发 送 短信 。 
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DE 


-555 521-5554 Es 


15555215554: hello 5556 


Sent: 16:22 


15555215554: hello 5556 


Me: hello 5556 





图 7.22 两 种 发 送 方式 的 结果 


7.3 语音 通话 


语音 通话 是 手机 设备 最 基本 和 最 重要 的 功能 ， 在 Android 系统 中 不 仅 可 以 统计 通话 号 
码 、 通 话 时 间 等 基本 信息 ， 我 们 还 可 以 很 方便 地 拨 出 号 码 、 自 动 挂 断 或 接 通 电话 以 及 电话 
录音 等 功能 。 在 这 一 节 中 ， 我 们 将 实现 拨 出 号 码 和 来 电 
防火 墙 的 功能 。 


D782 


| 昼 册 但 23.33] 


Ex Call 


7.3.1 呼出 电话 


1008g| 


-部 手机 最 基本 的 功能 就 是 电话 呼出 , 接 下 来 我 们 
将 实现 这 一 功能 。 实 现 这 一 功能 的 方法 和 发 送 短信 类 [ss | 
似 ， 都 有 两 种 方法 : 一 是 通过 系统 程序 实现 ， 二 是 直接 
呼出 电话 。 

1， 界 面 设计 

在 界面 上 我 们 需要 输入 拨 出 的 手机 号 码 以 及 触发 
功能 的 按钮 即 可 ， 实 现 如 图 7.23 所 示 。 


2. 使 用 系统 呼出 





图 7.23 呼出 电话 界面 
使 用 系统 自 带 的 应 用 程序 来 呼出 电话 ， 只 需要 使 用 Intent 跳 转 到 系统 电话 程序 ， 在 
Intent 中 附带 上 电话 号 码 即 可 ， 具 体 实现 如 下 : 


01 btn sys call.setOnClickListener (new OnClickListener() { 

















02 @Override 

03 public void onClick(View v) { 

04 // TODO Auto-generated method stub 

05 String number = edt number.getText() .toString(); 
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// 获 取 输 入 的 电话 号 码 
06 if (number.trim().length() == 0) { // 判 断 是 否 输入 
07 Toast .makeText (context， "请 输入 电话 号 码 "，1000) .show(); 
08 } else { 
09 Intent intent = new Intent(Intent.ACTION DIAL); 

// 创 建 跳 转 挨打 电话 意图 
10 intent.setData (Uri.parse("tel:" + number)); 

// 设 置 呼出 号 码 
1 startActivity (intent); // 跳 转 
也 下 
3 
Es 


其 中 ，05 行 ， 获 取 输 入 的 电话 号 码 ; 

06 一 07 行 ， 当 输入 为 空 时 ， 提 示 输 入 电话 号 码 ; 

09 一 11 行 ， 跳 转 到 系统 电话 程序 。 在 构造 意图 时 需要 注意 两 点 : 一 是 意图 Intent 的 动 
作 必 须 是 Intent.ACTION_DIAL; 二 是 在 号 码 前 需要 添加 tel:， 实 现 的 效果 如 图 7.24 所 示 。 
在 系统 拨号 界面 中 单 击 了 拨号 按钮 后 ， 才 会 呼出 电话 。 








图 7.24 跳 转 到 系统 拨号 界面 


3. 直接 拨号 


直接 使 用 拨号 呼出 电话 ， 应 用 程序 必须 具有 相应 的 权限 。 在 AndroidManifestxml 中 加 
入 该 权限 ， 代 码 如 下 : 
<!-- 拨 出 电话 --> 


<uses-permission android:name="android.permission.PROCESS 
OUTGOING CALLS" /> 


<!-- 电话 --> 


<uses-permission android:name="android.permission.CALL PHONE"/> 


直接 呼出 电话 和 使 用 系统 呼出 电话 类 似 ， 都 是 使 用 意图 Intent 来 实现 。 但 是 ， 两 者 的 
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Intent 的 动作 不 一 样 。 直接 呼出 电话 使 用 的 动作 为 mtentACTION CALL.。 具体 的 实现 如 下 : 


01 btn call.setonClickListener (new OnClickListener() { 


02 override 


03 public void onClick(View v) { 
04 String number = edt number.getText() .toString();// 获 取 输 入 号 码 
05 if (number.trim().length() == 0) { 
06 Toast .makeText (context, "请 输入 电话 号 码 "， 1000) .show(); 
07 } else { 
08 Intent intent = new Intent(Intent.ACTION CALL); 

// 创 建 拨号 意图 
09 intent.setData (Uri.parse ("tel:" + number) ) ;// 设 置 呼 出 号 码 
10 startActivity (intent); // 跳 转 
11 } 
12 } 
13 1}); 


其 中 ，04 一 06 行 ， 获 取 输 入 的 电话 号 码 ， 当 为 空 时 
提示 输入 号 码 ; 

08 一 10 行 ， 构 造 呼出 电话 意图 。 需 要 注意 的 是 意图 
Intent 的 动作 必须 是 Intent.ACTION_CALL 而 不 再 是 
IntentACTION_DIAL， 实 现 的 效果 如 图 7.25 所 示 。 


4. 分析 比较 


无 论 使 用 系统 程序 还 是 直接 呼出 电话 ， 在 实现 上 差 
别 不 大 ， 都 是 通过 意图 Intent 来 实现 。 但 是 使 用 系统 程 
序 不 需要 申请 权限 并 使 用 Intent 动作 IntentACTION 
DIAL; 而 直接 呼出 电话 需要 申请 权限 并 使 用 Intent 动作 
IntentACTION_CALL。 

通过 这 两 种 方式 来 呼出 电话 后 ， 在 系统 中 都 是 会 有 
通话 记录 的 。 这 一 点 和 直接 发 送 短 信 后 不 会 在 系统 短信 
中 保存 记录 是 不 一 样 的 。 





7.3.2 来 电 防火 墙 





动 而 居 23:34 


1-008-611 


图 7.25 直接 呼出 电话 


有 呼出 就 有 对 应 的 呼 入 电话 。 和 垃圾 短信 一 样 ， 我 们 同样 可 能 有 不 想 接 的 电话 。 接 下 


来 ， 我 们 实现 来 电 防火 墙 的 功能 。 
1. 功能 说 明 


和 手机 接收 到 短信 类 似 , 当 有 电话 呼 入 时 , 系统 会 使 用 广播 来 通知 给 所 有 的 应 用 程序 。 





当 我 们 在 接收 到 这 个 广播 的 时 候 ， 挂 断 电 话 。 








xml 中 加 入 该 权限 ， 代 码 如 下 : 
<!-- 改变 电话 状态 --> 


我 们 需要 获取 电话 状态 和 改变 电话 状态 , 这 些 都 需要 相应 的 权限 。 在 AndroidManifest. 


<uses-permission android:name="android.permission.MODIFY PHONE STATE" /> 
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<!-- 获取 电话 状态 --> 


<uses-permission android:name="android.permission.READ PHONE STATE" /> 
< 


<uses-permission android:name="android.permission.CALL PHONE"/> 
2. 电话 状态 信息 


当 电 话 状态 发 生 改 变 的 时 候 , 系统 会 广播 当前 电话 的 状态 。 我 们 使 用 TelephonyManager 
类 来 处 理 和 电话 相关 的 应 用 。 

(1) 获取 TelephonyManager 对 象 

TelephonyManager 是 系统 的 服务 ， 获 取 该 对 象 ， 实 现 如 下 : 


TelephonyManager tm = (TelephonyManager)Context.getSystemService 
(Context .TELEPHONY _ SERVICE) . 


(2) 公开 方法 

在 TelephonyManager 中 提供 了 很 多 有 用 的 方法 , 可 以 获取 当前 电话 状态 、SIM 卡 信 息 、 
电话 网 络 状 态 等 信息 。 人 常用 的 方法 有 : 

int getCallState () 

用 于 获取 当前 电话 的 状态 ， 返 回 值 有 : CALL STATE IDLE， 表 示 电 话 无 活动 ， 即 电 
话 已 经 被 挂 断 ; CALL STATE OFFHOOK ， 表 示 摘 机 ， 即 电话 正在 通话 中 ， 
CALL STATE RINGING， 表 示 响 铃 ， 即 有 电话 正在 呼 入 。 当 接收 到 广播 时 ， 我 们 就 根据 
这 些 不 同 的 电话 状态 进行 相应 的 处 理 ， 代 码 如 下 : 

int getSimState () 

用 于 获取 当前 手机 中 的 SIM 卡 的 状态 , 常用 的 返回 值 有 : SIM_STATE_READY, 表示 
SIM 卡 可 用 、 状 态 良 好 ; SIM_STATE_ABSENT， 表 示 没 有 SIM 卡 或 者 当前 SIM 不 可 用 。 

当 获 知 了 SIM 卡 可 用 时 ， 则 可 以 获取 SIM 卡 的 相关 信息 。SIM 卡 的 常用 信息 有 SIM 
卡号 、 运 营 商 编号 等 ， 获 取 其 信息 分 别 使 用 方法 如 下 : 

String getSimSerialNumber () 

获取 SIM 卡号 。 

String getSimoperator () 

获取 SIM 卡 的 提供 商 代码 。 代 码 由 国家 编号 和 网 络 标号 MCC+MNC (mobile country 
code + mobile network code) 共 同 组 成 。 

除了 可 以 获取 SIM 卡 本 身 的 信息 之 外 ， 当 手机 接 入 电话 网 络 时 , 我 们 可 以 获取 电话 通 
话 网 络 的 类 型 以 及 电话 数据 网 络 的 类 型 ， 分 别 使 用 方法 : 

int getPhoneType () 

获取 电话 网 络 类 型 。 返回 值 有 : PHONE_TYPE_NONE, 表示 无 信号 ; PHONE _ TYPE 
GSM， 表 示 GSM 信号 ; PHONE_TYPE_CDMA， 表 示 CDMA 信号 。 




















int getNetworkType() 


获取 当前 使 用 的 数据 网 络 类 型 。 返 回 值 包括 了 全 球 主要 的 网 络 类 型 ， 在 国内 常 使 用 到 
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的 有 :NETWORK _TYPE_UNKNOWN, 表示 网 络 类 型 未 知 类 型 ; NETWORK_TYPE _ GPRS， 
表示 GPRS 网 络 ; NETWORK _ TYPE EDGE, 表示 EDGE 网 络 ; NETWORK _ TYPE UMTS， 
表示 UMTS 网 络 。 

每 一 个 手机 设备 都 具有 唯一 的 标识 ， 获 取 该 标识 使 用 方法 : 


String getDeviceId() 


获取 设备 的 唯一 ID， 即 GSM 手机 的 IMEI 码 或 者 CDMA 手机 的 MEID 码 。 
从 上 面 介 绍 的 方法 中 ， 我 们 可 以 获取 手机 的 状态 、SIM 卡 的 详细 信息 等 ， 可 以 实现 基 
本 的 电话 信息 收集 。 


3， 隐藏 方法 使 用 


上 面 介绍 的 和 我 们 需要 实现 的 挂 断 电 话 没 有 任何 直接 的 关系 。 这 是 因为 Android 在 1.5 
版 本 之 后 ， 将 挂 断 电 话 、 接 通电 话 等 方法 不 再 显 式 提供 给 开发 使 用 。 但 是 ， 在 Android 源 
码 中 都 是 保留 了 这 些 方法 ， 只 是 都 是 隐藏 方法 。 接 下 来 ,我们 就 使 用 Java 的 反射 机 制 来 获 
得 这 些 方法 ， 需 要 如 下 几 步 : 

(1) 新 建 源码 包 

为 了 使 用 源码 中 的 方法 ， 我 们 需要 新 建 和 源码 中 的 同样 的 包 。 在 Src 目录 上 ， 在 右键 
菜单 中 单 击 new|Package 命令 。 在 弹出 的 对 话 框 中 ， 建 一 个 名 为 com.android.internal. 
telephony 的 包 ， 如 图 7.26 所 示 。 








Creates folders corresponding to packages. 





Souree folder: ex Call/sre 








None: Com. android internal telephony| 了] 


图 7.26 新 建 包 


在 该 包 中 添加 文件 ITelephonyaidl， 然 后 将 Android 源码 中 的 TTelephony.aidl 复制 到 该 
新 建文 件 中 。 我 们 可 以 在 线 查看 到 Android 源码 , 地 址 为 http://www.google.com/codesearch/ 
p?hl=enf#cZwlSNS7aEw/。 在 该 网 页 中 搜索 ITelephonyaidl， 便 可 以 找到 该 文件 ， 如 图 7.27 
所 示 。 








Thisisacached copy of hitp Sm 
Google code searchH mam i = 有 


”OSearch al code © Search in Android 
andioid / frameworks / base /telephony / java / com / android / intemal /telephony / ITelephony.aidl 











Files Telephony.aidl Licanse Apache - Data 
hem a patent drectotle 本 
@cat 
* Copyright (Cc) 2007 The Android Open Source Project 
cdma 入 
Bgsm + Licensed under the Apache Li 
国 sjp * you may not use this file except in ce 
®test * You may obtain a copy of the License ac 
ATParseEx java 9 7)» 
ATResponseParserjava = htpi//wawuapache org/ licenzea/LICENSE-2.0 
AdnRecord aidl 轩 
让 * Unless required by applicable lav or agreed to in 


图 7.27 ITelephony.aidl 地 址 
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同 理 ， 继 续 添加 com.android.telephony 包 ， 并 添加 NeighboringCellInfo.aidl 文件 。 添加 
该 文件 后 ， 如 果 文 件 ITelephony 中 还 出 现 import 包 错 误 ， 在 android.telephonyNeighboring- 
Cellmfo 前 添加 com.， 修 改 为 import com.android.telephony.NeighboringCellInfo. 成 功 添加 
包 的 效果 如 图 7.28 所 示 。 


ex Call 
BBsrec 
日 友 com. android internal. telephony 
ITelephony. ai 由 


日 友 com. android telephony 
司 NeiehborineCellInfo. aidl 
DB com. ouling. ex_Call 
由 四 call receiver. jaya 
由 四 Ex_Callhctivity. java 
由 [DD util. java 











gen [Generated Java Files] 


图 7.28 添加 源码 包 
(2) 实现 隐藏 方法 可 用 
我 们 使 用 Java 的 反射 机 制 ， 从 公开 的 TelephonyManager 中 实例 化 添加 的 源码 包 com. 
android.internal.telephony 中 的 ITelephony 接口 。 具 体 实现 如 下 : 
01 public class util { 


02 static public com.android.internal.telephony.ITelephony 
getITelephony (TelephonyManager telManager) 03 throws Exception { 
04 Method getITelephonyMethod = 
05 telManager .getClass () .getDeclared- 
Method ("getITelephony"); // 获 取 电 话 方 法 
06 getITelephonyMethod. setRccessible (true) ; “ // 设 置 隐藏 函数 也 能 使 用 
07 return 
08 (com.android.internal .telephony .ITelephony) 
getITelephonyMethod.invoke (telManager); 
09 3 
全 


(3) 挂 断 电话 实现 

在 隐藏 方法 中 ， 我 们 可 以 找到 挂 断 电话 的 方法 endCall0， 以 及 接 通 电话 的 方法 
answerRingingCall()。 我 们 就 使 用 这 些 隐藏 方法 来 实现 挂 断 电话 ， 具 体 实现 如 下 : 

01 TelephonyManager tm = (TelephonyManager) context 


02 -getSystemService (Service.TELEPHONY SERVICE); 
03 switch (tm.getCallstate()) { 
04 case TelephonyManager.CALL STATE RINGING: // 来 电 响 铃 
05 Log.i (TAG, "CALL STATE RINGING"); 
06 i | 
07 // 来 电 拒 听 
08 PhoneNumber = intent.getStringExtra("incoming number"); 
// 获 取 呼 入 号 码 
09 Log.i(TAG，"call number is "+phoneNumber); // 打 印 输出 
10 if (phoneNumber.equals("10086")) { // 判 断 号 码 是 否 为 拦截 的 号 码 10086 
1 util.getITelephony (tm) .endCall() ; ”// 获 取 隐 藏 方法 挂 断 电话 
汪 翅 Toast .makeText (context,，" 号 码 "” + phoneNumber + "已 经 被 挂 断 
拦截 "， 
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29 1000) -show() ; ”// 提 示 挂 断 电话 

14 Log .i (TAG，" 号 码 "” + phoneNumber + "已 经 被 挂 断 拦 截 "); 
jy } 

16 } catch (Exception e) { 

ky Log.i(TAG, "ring w " + e.toString()); 

18 } 

19 break; 

20 case TelephonyManager.CALL STATE OFFHOOK: // 来 电 接 通 ， 去 电 拨 出 
Pi Log.i(TAG, "CALL STRTE OFFHOOK"); 

之 公 break; 

23 case TelephonyManager.CALL STATE IDLE: // 电 话 挂 断 时 
24 Log.i(TAG, "CALL STATE IDLE"); 

25 break; 

26 上 


其 中 ，01 一 02 行 ， 获 取 电 话 管理 类 TelephonyManager; 


03 行 ， 获 取 当 前 电话 的 状态 ; 





04 一 15 行 ， 如 果 状 态 为 来 电 响 铃 状态 ， 则 根据 电话 号 码 挂 断 电 话 。 其 中 ，11 行 表示 使 


用 隐藏 方法 endcall0 来 挂 断 电话 。 
4. 广播 注册 


在 AndroidManifest 文件 中 注册 常 驻 广播 用 于 时 刻 可 获取 电话 状态 。 广 播 动 作为 系统 规 


定 的 android.intentaction. PHONE _ STATE。 具体 实现 如 下 : 


<receiver 
android:name=".call receiver" 
android:priority="10000" > 
<intent-filter > 


<action android:name="android.intent.action.PHONE STATE" /> 


</intent-filter> 
</receiver> 


5. 运行 分 析 


通过 上 面 的 步骤， 我 们 实现 了 对 10086 号 码 的 防 
火 墙 功能 。 使 用 Eclipse 的 DDMS 界面 中 的 Emulator 
Control， 可 以 指定 任意 号 码 拨打 电话 给 模拟 器 。 我 们 
使 用 号 码 10086 给 模拟 器 呼 入 电话 。 模 拟 器 没有 显示 
呼 入 电话 界面 ， 直 接 显示 了 “号 码 10086 已 经 被 挂 断 
拦截 ”的 提示 信息 ， 效 果 如 图 7.29 所 示 。 

6. 自动 接 通电 话 

在 使 用 Java 的 反射 机 制 获取 的 隐藏 方法 中 ， 我 们 
发 现 其 中 有 接 通 电话 的 方法 answerRingingCall0， 我 们 
可 以 使 用 该 方法 来 实现 自动 接 通 电话 。 

(1) 自动 接 通 

在 电话 状态 广播 中 ， 去 除 挂 断 电话 的 代码 ， 添 加 
自动 接 通 。 具 体 实现 如 下 : 











号 码 10086 已 经 被 挂 断 拦截 


全 @ 


图 7.29 拦截 来 电 
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01 case TelephonyManager.CALL STATE RINGING : // 来 电 响 铃 
02 // 静 默 接 通 电话 

03 util.getITelephony (tm) .silenceRinger (); // 静 铃 

04 util.getITelephony (tm) .answerRingingCall (); // 自 动 接听 
05 Timer timer = new Timer() 

06 timer.schedule (task, 300); 


其 中 ，03 行 ， 设 置 电 话 静音 ， 当 来 电 时 不 会 响 铃 也 不 会 震动 ; 

04 行 ， 自 动 接 通电 话 。 

(2) 隐藏 接 通 界面 

由 于 在 接 通 电话 后 ， 系 统 自动 会 显示 接 通电 话 的 界面 。 为 了 提高 自动 接 通电 话 的 隐藏 
性 ， 我 们 隐藏 该 通话 界面 跳 转 到 主 界面 。 由 于 模拟 器 处 理 速度 的 问题 ， 并 不 会 在 我 们 接 通 
电话 后 立刻 显示 通话 界面 ， 我 们 使 用 一 个 延 时 的 跳 转 ， 实 现 如 下 : 


01 TimerTask task = new TimerTask() { 
02 public void run() { 





03 Intent i = new Intent(Intent.ACTION MAIN); // 创 建 意图 

04 i.addCategory (Intent .CATEGORY HOME); // 设 置 显示 主 界面 
05 i.addFlags (Intent .FLAG ACTIVITY NEW TASK); 

06 mcontext.startActivity (i); 

07 Loged (TAGy "task Start™ys 

08 1 

0SE 


(3) 运行 分 析 
由 于 我 们 在 代码 中 实现 了 号 码 判断 的 功能 , 对 任何 来 电 
都 会 自动 接 通 。 我 们 使 用 Emulator Control 向 模拟 器 呼 入 电 
话 ， 当 电话 呼 入 时 ， 通 话 界面 出 现 一 瞬间 后 跳 转 到 Android 
主 界面 中 。 当 然 ， 在 状态 提示 栏 中 会 出 现 正在 通话 的 标识 ， 
如 图 7.30 所 示 。 

在 这 一 节 中 ,我 们 通过 多 个 实例 实现 了 呼出 、 呼 入 电话 
时 的 常见 处 理 。 在 呼 入 电话 时 ， 我 们 更 是 使 用 到 了 Android 
已 隐藏 的 方法 来 实现 我 们 需要 的 功能 。 所 以 ， 在 进行 应 用 开 
发 的 时 候 ， 对 于 Android 的 源码 需要 有 一 定 的 了 解 ， 这 样 可 
以 加 深 对 Android 系统 处 理 的 理解 ， 从 而 开发 出 更 符合 
Android 框架 或 功能 更 强大 的 应 用 程序 。 








图 7.30 自动 接 通 


7.4 桌面 备忘录 


当 我 们 启动 Android 后 ， 在 桌面 上 可 以 看 到 很 多 的 图 标 ， 其 中 有 类 似 Windows 平台 的 
快捷 方式 ， 用 于 启动 应 用 程序 ， 有 的 本 身 就 是 一 个 小 的 应 用 程序 AppWidget。Widget 在 桌 
面 上 可 以 显示 应 用 程序 提供 的 内 容 ， 也 可 以 和 服务 交互 ， 如 暂停 歌曲 。 在 这 一 节 ， 我 们 将 
实现 一 个 桌面 应 用 程序 widget， 用 于 提示 用 户 需 要 做 的 事情 ， 实 现 备忘录 的 功能 

我 们 需要 在 桌面 上 明显 地 显示 出 备忘录 的 内 容 , 这 一 部 分 由 Widget 来 完成 , 实现 效果 
如 图 7.31 所 示 。 另 一 方面 ， 我 们 需要 对 备忘录 的 内 容 进 行 添加 和 删除 ， 实 现 效果 如 图 7.32 
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Ex Widget 


hello appwidget 
学 习 android 





图 7.31 桌面 Widget 图 7.32 添加 内 容 


7.4.1 桌面 实现 


Android 系统 中 的 AppWidget， 和 一 般 的 应 用 程序 的 界面 布局 和 功能 实现 有 一 些 差别 。 
下 面 ， 我 们 就 通过 桌面 备忘录 来 介绍 AppWidget 的 实现 。 


1. AppWidget 配 置 


AppWidget 的 描述 不 再 直接 由 layout 目录 中 的 XML 文件 指定 , 而 是 以 XML 文件 的 形 
式 存 在 于 应 用 程序 的 res/xml/ 目 录 下 。 其 主要 描述 的 是 Widget 的 大 小 、 更 新 频率 和 初始 界 
面 等 信息 。 

在 配置 的 XML 文件 中 ， 使 用 标签 appwidget-provider 来 标识 该 部 分 内 容 为 Widget 的 
配置 描述 。 常 用 的 配置 信息 有 : 

口 android:minWidth 表示 AppWidget 的 最 小 宽度 。 

口 android:minHeight 表示 AppWidget 的 最 小 高 度 。 

口 android:updatePeriodMillis 表示 组 件 的 更 新 时 间 ， 以 毫秒 计算 。 但 是 版 本 1.5 之 后 

要 求 更 新 时 间 不 小 于 30 分 钟 。 如 果 有 小 于 30 分 钟 的 更 新 ， 需 要 自己 使 用 服务 来 

实现 更 新 。 

口 android:initialLayout 表示 组 件 布局 XML 的 位 置 。 

口 android:configure 用 于 设置 在 Widget 启动 前 启动 的 Activity， 如 果 不 会 启动 则 无 需 
设置 。 

本 实例 中 ， 在 res/xml/ 目 录 中 ， 添 加 文件 widget info xml， 文 件 内 容 如 下 : 


<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/ 
android" 
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android:minWidth="300dp" 
android:minHeight="30dp" 
android:initialLayout="@layout/widget"> 
</appwidget-provider> 
其 中 ， 指 定 组 件 布 局 由 layout 目录 中 的 widgetxml 描述 ， 实 现 了 图 片 和 文字 ， 效 果 如 
图 7.31 所 示 。 


2. 继承 AppWidgetProvider 类 





实现 Widget 需要 继承 类 AppWidgetProvider， 而 AppWidgetProvider 类 继承 自 广播 

BroadcastReceiver。 所 以 ， 整 个 AppWidgetProvider 类 是 以 接收 广播 的 形式 来 驱动 的 ， 常 用 

的 方法 有 : 

口 onEnabled(Context context): 当 这 个 App Widget 第 一 次 被 放 在 桌面 上 时 被 调用 。 

DQ onUpdate(Context context, AppWidgetManager appWidgetManager, int[] 
appWidgetIds): 当 Widget 的 自动 更 新 时 间 到 了 或 者 其 他 会 导致 Widget 发 生变 化 的 
事件 发 生 时 调用 。 其 中 , 参数 appWidgetManager 是 Widget 的 管理 器 , appWidgetlds 
是 该 Widget 的 所 有 实例 编号 。 

我 们 通常 使 用 AppWidgetManager 来 更 新 Widget 的 显示 ， 使 用 方法 : 


void updateAppWidget (int appWidgetId, RemoteViews views) 
void updateAppWidget (ComponentName provider, RemoteViews views) 





这 两 个 方法 分 别 通过 appWidgetId 编号 和 ComponentName 来 指定 Widget， 将 指定 的 
Widget 显示 修改 为 RemoteView 的 显示 。 其 中 ， 参 数 views 是 RemoteViews 类 型 的 显示 。 
而 RemoteView 类 是 专门 用 来 描述 一 个 垮 进程 显示 的 view， 这 样 我 们 就 可 以 实现 对 桌面 
Widget 的 显示 更 新 。 

口 onDeleted(Context context, int[] appWidgetIds): 当 一 个 App Widget 从 桌面 上 删除 时 


调用 。 
口 onDisabled(Context context): 当 这 个 App Widget 的 最 后 一 个 实例 被 从 桌面 上 移 除 
时 会 调用 该 方法 。 


口 onReceive(Context context, Intent intent): 用 于 接收 其 他 广播 。 

在 这 些 函 数 中 ， 我 们 最 常用 的 方法 就 是 onUpdate0 和 onReceive()。 

3. 实现 onUpdate() 

在 桌面 备忘录 中 ， 我 们 需要 更 新 显示 的 备忘录 内 容 ; 另 一 方面 ， 我 们 通过 单 击 桌面 
Widget， 弹 出 修改 备忘录 内 容 的 界面 。 所 以 在 onUpdate() 方 法 中 ， 既 要 更 新 显示 也 需要 添 
加 单 击 处 理事 件 。 

在 RemoteViews 类 中 ， 提 供 了 更 新 UI 常用 的 方法 和 单 击 事件 处 理 ， 方 法 如 下 : 

void setTextColor (int viewlId, int color) 

用 于 更 新 文字 颜色 。 参 数 viewId 是 控件 的 id 号 ，color 是 颜色 编号 。 对 于 文字 内 容 修 
改 的 使 用 方法 如 下 : 


void setTextViewText (int viewId, CharSequence text) 


于 更 新 显示 的 文字 内 容 。 参 数 text 是 显示 的 文字 内 容 。 除 了 文字 内 容 ， 对 于 显示 的 
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图 片 也 可 以 进行 更 新 ， 使 用 方法 如 下 : 


void setImageViewBitmap (int viewId, Bitmap bitmap) 

用 于 更 新 显示 的 图 片 。 参 数 bitmap 是 显示 的 图 片 。 

除了 上 述 的 显示 UI 的 更 新 方法 外 ， 对 于 单 击 事件 处 理 ， 使 用 方法 如 下 : 

void setOnClickPendingIntent (int viewId, PendingIntent pendingIntent) 
用 于 添加 单 击 事件 ， 当 单 击 后 广播 pendingIntent。 

熟悉 了 更 新 的 过 程 并 掌握 了 更 新 的 方法 后 ， 我 们 具体 的 实现 代码 如 下 : 

01 public void onUpdate (Context context, AppWidgetManager 





appWidgetManager, 

02 int[] appWidgetIds) { // 重 写实 现 更 新 函数 

03 Log.d(TAG, "onUpdate"); 

04 final int N = appWidgetIds.length; // 获 取 该 Widget 个 数 

05 for, (int 1 = 0 1 < MN 1+4) TY // 遍 历 该 Widget 的 所 有 实例 

06 int appWidgetId = appWidgetIds [i]; 

07 Log i(TAGE i Lo He 

08 View = new RemoteViews (Context.getPackageName () ,R.layout. 
widget); // 设 置 显示 布局 

09 // 显 示 输入 的 内 容 

10 SharedPreferences shared = context .getSharedPreferences 
("settinginfo", 

1 Activity.MODE PRIVRTE) // 获 取 显 示 内 容 

12 View.setTextViewText (R.id.appwidget text，shared.getString 
("content", context 

13 .getResources () .getString(R.string.hi))); // 设 置 显示 

14 Intent intentClick = new Intent (CLICK ACTION) ; // 设 置 单 击 意图 

15 PendingIntent pendingIntent = PendingIntent.getBroadcast 
(context, 0, intentClick, 0); 

16 View.setOonClickPendingIntent (R.id.appwidget text, 
pendingIntent); // 设 置 单 击 广播 

17 appWidgeManger .updateAppWidget (appWidgetId，view) ;// 更 新 显示 

18 } 

L900 上 

其 中 ，01 一 05 行 ， 重 写 onUpdate0 方 法 ， 对 该 Widget 的 所 有 实例 都 进行 更 新 ; 


08 行 ， 实 例 化 一 个 RemoteViews， 用 来 对 当 前 Widget 进行 更 新 设置 ; 
09 一 13 行 ， 从 SharedPreferences 中 读 取 显 示 的 备忘录 内 容 ， 并 显示 在 Widget 中 ; 
14 一 16 行 ， 设置 Widget 的 单 击 事件 。 当 单 击 后 ， 发 送 广 播 ， 动 作为 自 定 义 的 


CLICK ACTION; 


17 行 ， 使 用 AppWidgetManager 来 更 新 Widget 的 显示 。 


4. 实现 onReceive() 





在 onUpdate() 方 法 中 ， 我 们 实现 了 单 击 Widget 后 发 送 一 个 广播 ， 但 是 对 于 这 个 广播 ， 


我 们 并 没有 进行 处 理 。 我 们 在 enn 处 理 。 我 们 在 单 击 后 ， 只 需要 








显示 添加 备忘录 内 容 的 界面 ， 如 图 7.32 所 示 。 具 体 的 代码 实现 如 下 : 


01 public void onReceive (Context context， Intent intent) { // 广 播 接收 器 
02 super.onReceive (context, intent); 
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03 Log.i (TAG, "onReceive, intent action is " + intent.getAction()); 

04 if (intent.getAction() .equals (CLICK ACTION)) { // 广 播 动作 匹配 时 

05 Intent intent activity=new Intent (context, Ex WidgetActivity. 
class); // 跳 转 到 添加 内 容 界 面 

06 context.startActivity (intent activity) ; // 界 面 跳 转 

07 

08 } 

5. 广播 注册 


由 于 继承 的 AppWidgetProvider 类 是 一 个 广播 类 ， 所 以 需要 在 AndroidManifest.xml 中 
注册 该 广播 。 除 了 实现 一 般 的 广播 注册 之 外 ， 还 需要 特别 注意 添加 该 Widget 的 响应 标识 。 
其 中 name 是 固定 的 ， 必 须 是 android.appwidgetprovider。resource 指定 该 Widget 的 配置 文 
件 。 本 实例 中 的 广播 注册 实现 如 下 : 


<receiver android:name=".myAppWidgetProvider" > 


<meta-data 


android:name="android.appwidget .provider" 
android:resource="@xml/widget info" > 


</meta-data> 
<intent-filter > 


<action android:name="com.ouling.action.widgetclick"/ > 
<action android:name="android.appwidget .action.APPWIDGET 
UPDATE" /> 


</intent-filter> 
</receiver> 


通过 这 些 步骤 , 我 们 已 经 实现 了 桌面 备忘录 Widget 在 桌面 的 显示 和 单 击 事件 处 理 , 完 
成 了 该 Widget 的 主要 部 分 。 接 下 来 ， 实 现 添 加 备 态 录 的 内 容 。 


7.4.2 内 容 添加 


在 界面 中 ， 我 们 只 需要 更 改 备忘录 内 容 的 可 编辑 框 和 一 个 保存 按钮 即 可 ， 实 现 效 果 如 
图 7.32 所 示 。 当 初始 化 显示 时 ， 从 SharedPreferences 中 读 取 当前 显示 的 数据 ， 在 编辑 框 显 
示 该 数据 ， 以 方便 删除 和 添加 备忘录 信息 。 当 修改 完成 后 ， 需 要 将 修改 后 的 内 容 保存 到 
SharedPreferences 中 ， 并 更 新 Widget 的 显示 。 

修改 完成 后 ， 单 击 保存 按钮 。 具 体 实现 如 下 : 


01 mButton.setOonClickListener (new OnClickListener() { 





@Override 
public void onClick(View v) { 


String text = mEditText.getText() .toString(); // 获 取 输 入 的 内 容 
if (text.equals("")) { // 判 断 输 入 内 容 是 否 为 空 
return; 


} 


SharedPreferences shared = getSharedPreferences ("settinginfo", 
Rctivity.MODE PRIVATE) ; // 获 得 SharedPreferences 来 保存 内 容 
SharedPreferences.Editor editor = shared.edit() ;// 获 得 编辑 器 
editor.putSstring ("content", text); // 修 改 添 加 内 容 
editor.commit(); // 添 加 修改 


RemoteViews views = new RemoteViews (Ex WidgetActivity.this 
-getPackageName (), R.layout.widget); // 实 例 化 视图 
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16 Views.setTextViewText (R.id.appwidget text，text) ; // 设 置 显示 内 容 

yy 

18 ComponentName widget = new ComponentName ( 

19 Ex WidgetActivity.this, myAppWidgetProvider.class);// 
20 AppWidgetManager manager = AppWidgetManager 

人 -getInstance (Ex WidgetRactivity-this);// 获 取 Widget 管理 器 
22 manager .updateAppWidget (widget, views); // 提 交 更 新 UI 

23 Ex WidgetActivity.this.finish(); // 结 束 当前 界面 

24 } 

25 1}); 


其 中 ，03 一 07 行 ， 获 取 修 改 后 的 内 容 ， 如 果 内 容 为 空 ， 则 不 予 显示 ; 

08 一 12 行 ， 将 修改 后 的 内 容 保存 在 SharedPreferences 中 ; 

14 一 16 行 ， 实 例 化 RemoteViews， 并 对 当前 Widget 的 显示 内 容 进 行 更 新 ; 
18 一 22 行 ， 使 用 AppWidgetManager 来 提交 UI 的 更 新 ; 

23 行 ， 结 束 修改 内 容 的 Activity， 返 回 桌面 。 


7.4.3 ”Widget 运行 


1， 添加 Widget 


Widget 和 一 般 的 应 用 程序 不 一 样 ， 添 加 Widget 的 步骤 如 下 : 
(1) 在 桌面 界面 时 ， 单 击 Menu 按钮 ， 如 图 7.33 右 侧 所 示 。 再 在 屏幕 显示 中 选择 Add， 
则 会 出 现 添加 桌面 组 件 的 画面 ， 如 图 7.34 所 示 。 或 者 长 按 主 界面 也 能 出 现 该 选择 界面 。 


Wallpaper 


a @ © 


Search Notifications Setting 





图 7.33 添加 Widget 


(2) 在 添加 组 件 界面 中 ， 选 择 Widgets， 如 图 7.34 所 示 。 然 后 ， 出 现 了 系统 中 所 有 的 
Widget 程序 ， 包 括 了 很 多 系统 本 身 的 Widget。 选 中 我 们 的 桌面 备忘录 一 一 Ex_ Widget， 如 
图 7.35 所 示 。 


ys 
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图 7.34 选择 Widgets 图 7.35 添加 桌面 备忘录 


(3) 通过 这 两 步 ， 就 在 桌面 成 功 添加 了 桌面 备忘录 Widget， 如 本 节 最 开始 的 图 7.31 
所 示 。 


2. 运行 分 析 


通过 以 上 步骤 ， 我 们 实现 了 桌面 备忘录 。 在 初始 化 的 备忘录 中 ， 只 有 内 容 hello 
appwidget， 如 图 7.31 所 示 。 单 击 Widget 后 ， 跳 转 到 备忘录 添加 界面 ， 添 加 内 容 “ 学 习 
android”， 如 图 7.32 所 示 。 当 单 击 “ 保 存 ” 按 钮 返回 桌面 后 ， 我 们 发 现 桌面 Widget 的 内 容 
发 生 了 变化 ， 显 示 了 添加 的 内 容 ， 如 图 7.36 所 示 。 

当 我 们 在 桌面 上 不 需要 Widget 显示 时 ， 长 按 Widget。 这 时 ， 屏 幕 下 方 会 出 现 一 个 垃圾 
箱 的 图 标 ， 将 需要 删除 的 Widget 拖 入 该 垃圾 箱 ， 即 可 删除 该 Widget。 效 果 如 图 7.37 所 示 。 








图 7.36 修改 内 容 后 图 7.37 删除 Widget 
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AppWidget 能 够 方便 用 户 可 以 直接 查看 需要 的 信息 或 实现 便捷 的 功能 。 在 实现 一 个 
AppWidget 时 ， 需 要 注意 Widget 的 配置 、 继 承 AppWidgetProvider 的 方法 。 在 实现 过 程 中 ， 
重点 使 用 RemoteViews 来 路 进程 地 更 新 UI 以 及 AppWidgetManger 的 管理 。 





7.5 本 章 总 结 


本 章 介 绍 了 Android 手机 必 不 可 少 的 短信 和 通话 功能 。 通 过 导出 短信 、 收 发 短信 、 呼 
入 呼出 电话 等 手机 相关 的 常用 功能 ， 详 细 介 绍 了 Android 系统 处 理 短信 以 及 电话 的 特点 。 
这 些 都 是 本 章 的 重点 和 难点 ， 是 在 进行 手机 通讯 的 相关 开发 中 ， 必 须 掌 握 的 技能 。 

同时 ， 本 章 还 介绍 了 Android 中 特色 的 桌面 组 件 Widget， 使 用 它 可 以 开发 出 更 方便 用 
户 使 用 的 程序 。 








【习题 1】 结 合 7.1 节 短 信和 导出 的 相关 内 容 ， 实 现 查 找 含有 指定 内 容 的 所 有 短信 。 


全 提示 : 查找 含有 指定 内 容 的 短信 和 查找 指定 号 码 的 短信 类 似 ， 需 要 在 短信 数据 库 中 查找 
匹配 的 短信 内 容 。 


关键 代码 : 


Cursor cur = cr.query (uri, projection, "body like '%" + content + "'", null, 
"date desc"); 


【习题 2】 结合 7.2 节 短信 收发 的 相关 内 容 ， 实 现 对 指定 号 码 短信 的 自动 回复 。 


全 提示 : 在 短信 防火 墙 小 节 中 ， 我 们 实现 了 获取 短信 的 发 送 号 码 ， 如 果 该 号 码 是 指定 号 码 
则 自动 发 送 短信 。 


关键 代码 : 


if (message.getDisplayOriginatingAddress() .equals("5556")) { 
SmsManager sms = SmsManager.getDefault(); 
String message = “正在 学 习 中 ， 稍 后 跟 你 联系 ”; 
if (message.length() > 70) { 
ArrayList<String> msgs = sms.divideMessage (message); 
for (String msg : msgs) { 
sms.sendTextMessage (ph num, null, msg, sent pi, deliver pi); 





加 


上 
} 
【习题 3】 结 合 7.3 节 语音 通话 和 6.2 节 音 频 录制 的 相关 内 容 ， 实 现 电话 录音 的 功能 。 
很 提示 : 参考 语音 通话 一 节 ， 获 取 当 前 电话 状态 ， 如 果 是 正在 通话 状态 则 启动 音频 录制 。 
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随 着 现在 移动 设备 功能 越 来 越 丰富 ， 大 多 数 设备 都 提供 了 许多 其 他 的 实用 功能 ， 如 能 
够 改变 人 机 交互 方式 的 各 种 传感器 、 能 够 提供 地 理 信 息 的 GPS 定位 和 基站 定位 等 功能 ， 结 
合 这 些 功能 可 以 开发 出 更 加 有 意思 的 应 用 。 有 一 些 使 用 重力 传感器 或 者 方向 传感器 的 游戏 ， 
如 典型 的 控制 赛车 转弯 操作 ， 就 是 基于 LBS 的 应 用 如 Foursquare。 本 章 就 将 介绍 如 何在 开 
发 中 使 用 这 些 功 能 。 另 外 ， 在 本 章 的 后 半 部 分 还 会 对 Android 的 桌面 快捷 方式 及 桌面 插件 
(Widget) 进行 介绍 。 





8.1 访问 传感器 


为 了 方便 对 传感器 的 访问 ，Android 提供 了 用 于 访问 硬件 的 API 一 一 android.hardware 
包 ，, 该 包 主要 提供 了 用 于 访问 Camera〈 相 机 ) 和 Sensor (传感器 ) 的 类 和 接口 ， 关 于 相机 
的 使 用 已 经 在 第 6.4 节 中 有 了 说 明 。 现 在 就 来 介绍 一 下 Android 系统 下 如 何 使 用 传感器 。 

在 Android 应 用 程序 中 使 用 传感器 要 依赖 于 android.hardware.SensorEventListener 接 口 。 
通过 该 接口 可 以 监听 传感器 的 各 种 事件 。SensorEventListener 接口 如 下 : 


01 package android.hardware; 
02 public interface SensorEventListener { 


03 public abstract void onSensorChanged (SensorEvent event); 
// 传 感 器 采样 值 发 生变 化 时 调用 
04 public abstract void onAccuracyChanged (Sensor sensor, int accuracy); 
// 传 感 器 精度 发 生 改 变 时 调用 


D050 


接口 包括 了 如 上 段 代码 中 所 声明 的 两 个 方法 ， 其 中 onAccuracyChanged 方法 在 一 般 场 
合 中 比较 少 使 用 到 ,常用 到 的 是 onSensorChanged 方法 , 它 只 有 一 个 SensorEvent 类 型 的 参 
数 event，SensorEvent 类 代表 了 一 次 传感器 的 响应 事件 ， 当 系统 从 传感器 获取 到 信息 的 变 
更 时 ， 会 捕获 该 信息 并 向 上 层 返回 一 个 SensorEvent 类 型 的 对 象 ， 这 个 对 象 包含 了 传感器 
类 型 (public Sensor sensor)、 传 感 事件 的 时 间 惟 (public long timestamp )、 传 感 器 数值 的 精 
度 (public int accuracy) 以 及 传感器 的 具体 数值 (public final float[] values ) 。 

其 中 的 values 值 非常 重要 ， 其 数据 类 型 是 Boat[]， 它 代表 了 从 各 种 传感器 采集 回 的 数 
值 信息 ， 该 float 型 的 数组 最 多 包含 3 个 成 员 ， 根 据 传感器 的 不 同 ，values 中 每 个 成 员 所 代 
表 的 含义 也 不 同 。 例 如 ， 通 常温 度 传感器 仅仅 传 回 一 个 用 于 表示 温度 的 数值 ， 而 加 速度 传 
感 器 则 需要 传 回 一 个 包含 X、Y、Z 三 个 轴 上 的 加 速度 数值 ， 同 样 的 一 个 数据 “10”， 如 果 
是 从 温度 传感器 传 回 则 可 能 代表 10 摄氏 度 ， 而 如 果 从 亮度 传感器 传 回 则 可 能 代表 数值 为 
10 的 亮度 单位 ， 如 此 等 等 。 
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应 用 程序 就 可 以 通过 Sensor 类 型 和 values 数组 的 值 来 正确 地 处 理 并 使 用 传感器 传 回 的 
值 。 为 了 正确 理解 传感器 所 传 回 的 数值 ， 这 里 首先 介绍 Android 所 定义 的 两 个 坐标 系 ， 即 
世界 坐标 系 〈world coordinate-system) 和 旋转 坐标 系 (rotation coordinate-system ) 。 











8.1.1 世界 坐标 系 


如 图 8.1 所 示 ， 这 个 坐标 系 定义 了 从 一 个 特定 的 Android 设备 上 看 待 外 部 世界 的 方式 ， 
主要 是 以 设备 的 屏幕 为 基准 而 定义 ， 并 且 该 坐标 系 依赖 的 是 屏幕 的 默认 方向 ， 不 因为 屏幕 
显示 方向 的 改变 而 改变 。 

坐标 系 以 屏幕 的 中 心 为 圆 点 ， 其 中 ; 

口 xX 轴 : 方向 是 沿 着 屏幕 的 水 平方 向 从 左 向 右 。 手 机 默认 的 正 放 状 态 ， 一 般 来 说 即 

是 如 图 8.1 所 示 的 默认 长 边 在 左右 两 侧 ， 并且 听 简 在 上 方 的 情况 ,如 果 是 特殊 的 设 
备 ， 则 可 能 和 和 立轴 会 互 换 。 

口 Y 轴 : 方向 与 屏幕 的 侧 边 平行 ， 是 从 屏幕 的 正中 心 开 始 沿 着 平行 屏幕 侧 边 的 方向 

指向 屏幕 的 顶端 。 

口 Z 轴 :; Z 轴 的 方向 比较 直观 , 即将 手机 屏幕 朝 上 平 放 在 桌面 上 时 ,屏幕 所 朝 的 方向 。 

有 了 约定 好 的 世界 坐标 系 ， 重 力 传感器 、 加 速度 传感器 等 等 所 传 回 的 数据 和 解析 数据 
的 方法 ， 就 能 够 按照 这 种 约定 来 确立 联系 了 。 


8.1.2 ”旋转 坐标 系 











如 图 8.2 所 示 ， 球 体 可 以 理解 为 地 球 ， 这 个 坐标 系 是 专用 于 方位 传感器 (Orientation 
Sensor) 的 ， 可 以 理解 为 一 个 “ 反 向 的 (inverted)” 世 界 坐 标 系 ， 方 位 传感器 用 于 描述 设 
备 所 朝向 的 方向 的 传感器 ， 而 Android 为 描述 这 个 方向 而 定义 了 一 个 坐标 系 ， 这 个 坐标 系 
也 由 X、Y、2Z 轴 构 成 ， 特 别 之 处 是 方向 传感器 所 传 回 的 数值 是 屏幕 从 标准 位 置 〈 屏 幕 水 
平 朝 上 且 正 北 ) 开始 ， 分 别 以 这 3 个 坐标 轴 为 轴 所 旋转 的 角度 。 使 用 方位 传感器 的 典型 用 
例 即 “电子 罗盘 ”。 





图 8.1 Android 设备 的 世界 坐标 系 8.2 ”旋转 坐标 系 
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在 这 个 坐标 系 中 : 
口 X 轴 : 即 Y 轴 与 Z 轴 的 向 量 积 Y。Z， 方 位 是 与 地 球 球面 相 切 并 且 指 向 地 理 的 
西方 。 


口 立轴 : 为 设备 当前 所 在 位 置 与 地 面相 切 并 且 指向 地 磁 北 极 的 方向 。 

口 Z 轴 : 为 设备 所 在 位 置 指向 地 心 的 方向 ， 垂 直 于 地 面 。 

由 于 这 个 坐标 系 是 专用 于 确定 设备 的 方向 的 ， 因 此 这 里 进一步 介绍 访问 传感器 所 传 回 
的 je pe $ 义 ， 作 为 对 values[] 值 的 一 种 示例 说 明 。 当 方向 传 感 
器 感应 到 方位 变化 时 会 返回 包含 变化 结果 数值 的 数组 ， 即 values[]， 数 组 的 长 度 为 3， 
它们 分 别 代表 : 

口 values[0]: 方位 角 ， 即 手机 绕 Z 轴 所 旋转 的 角度 。 

口 values[1]: 倾斜 角 ， 指 绕 X 轴 所 旋转 的 角度 。 

口 values[2]: 翻 深 角 ， 指 绕 Y 轴 所 旋转 的 角度 

以 上 所 指明 的 角度 都 是 逆 时 针 方 向 的 。 














8.1.3 获取 传感器 清单 〈 需 要 真 机 ) 


由 于 Android 平台 的 开放 性 ， 使 用 Android 作为 系统 平台 的 手机 类 型 相当 的 多 ， 各 种 
类 型 的 手机 不 仅仅 针对 自身 硬件 或 者 其 他 方面 的 需求 做 了 一 些 定制 ， 而 且 在 传感器 的 支持 
上 也 不 尽 相 同 。 

目前 ，Android SDK 2.3.3 版 本 支持 的 传感器 类 型 包括 方向 传感器 、 加 深入 We 重 
力 传感器 、 温 度 传感器 、 压 力 传感器 、 磁 场 传感器 、 陀 螺 仪 、 亮 度 传感器 、 度 传感器 
等 。 市 面 上 出 售 的 Android 手机 随 着 时 间 et he 那么 ， 如 
何 能 够 获知 当前 的 手机 设备 上 所 提供 的 所 有 传感器 的 类 型 呢 ? 

本 小 节 就 将 通过 一 个 示例 来 说 明 如 何 获取 一 个 手机 所 提供 的 传感器 列表 。 在 实际 应 用 
开发 中 ， 对 设备 是 否 支持 特定 的 传感器 类 型 的 检测 也 是 提高 代码 健壮 性 的 一 个 因素 。 


1. 功能 说 明 





获取 当前 运行 的 设备 上 所 支持 的 传感器 并 以 列表 的 形式 显示 在 TextView 中 ， 如 图 8.3 


支持 的 传感器 列表 
)LH 3- A 





图 8.3 获取 的 传感器 清单 


2. 代码 实现 


为 了 获取 当前 手机 上 已 连接 的 传感器 清单 ， 需 要 借助 于 SensorManager 的 
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getSensorList() 方 法 ， 首 先 需要 获取 一 个 SensorManager 类 的 实例 ， 方 法 如 下 : 


01 private SensorManager mSensorManager; 
02 mSensorManager = (SensorManager)getSystemService (SENSOR SERVICE); 


// 从 系统 服务 获取 SensorManager 对 象 


获取 SensorManager 对 象 的 方法 是 使 用 Activity.getSystemService0 方 法 , 即 获取 了 一 个 
系统 服务 ， 方 法 的 唯一 参数 是 string 类 型 ， 通 过 该 string 类 型 的 参数 作为 标识 符 来 寻找 指 
定 的 系统 服务 对 象 。 这 里 使 用 到 的 SENSOR_SERVICE 则 是 由 Context 类 所 定义 的 一 个 具 
名 常量 ， 实 际 的 值 是 字符 串 “sensor”， 方 法 根据 参数 SENSOR_SERVICE 返回 了 一 个 
SensorManager 对 象 实例 。 

在 获取 了 当前 系统 的 SensorManager 类 的 对 象 后 ， 就 可 以 通过 其 getSensorList() 方 法 来 
获取 相应 的 传感器 清单 了 ， 方 法 如 下 : 


List<Sensor> sensors = mSensorManager.getSensorList (Sensor.TYPE ALL); 


// 获 取 所 有 传感器 的 列表 


这 个 方法 的 参数 是 int 类 型 ， 类 似 于 getSystemService 方法 ,该 参数 用 于 指定 返回 何 种 
类 型 的 传感器 清单 ,而 Sensor.TYPE_ALL 则 指 代 了 所 有 的 传感器 类 型 ， 因 此 使 用 该 值 作为 
参数 将 返回 一 个 当前 系统 所 连接 的 所 有 传感器 的 清单 。 当 然 ， 通 过 指定 特定 的 类 型 ， 如 
SensorTYPE ACCELEROMETER 则 会 返回 加 速度 传感器 的 清单 ， 这 个 清单 长 度 可 以 是 0， 
也 可 能 是 1 或 者 更 多 ， 这 取决 于 当前 手机 上 是 否 存在 正常 工作 的 加 速度 传感器 或 者 存在 着 





多 个 加 速度 传感器 。 
获取 了 传感器 清单 后 ， 通 过 如 下 代码 将 每 个 传感器 的 名 称 依次 显示 到 TextView 上 : 
01 sensorList = (TextView) findViewById(R.id.sensorlist) 
// 绑 定 TextView 

02 for (Sensor sensor:sensors) // 遍 历 传感器 列表 

03 { 

04 // 在 TextView 中 输出 传感器 的 名 称 

05 sensorList.append(sensor.getName () + "\n"); 

06 } 

如 代码 所 示 , 只 需要 简单 地 对 这 个 List 中 的 所 有 sensor 对 象 依次 使 用 sensor.getName() 
方法 , 就 能 够 获取 每 个 传感器 的 名 称 , 然后 通过 TextView 的 append(string) 方 法 将 名 称 显示 
出 来 ， 便 得 到 了 如 图 8.3 所 示 的 结果 ， 从 结果 中 可 以 看 出 ， 该 款 真 机 支持 了 如 下 型 号 的 共 
6 种 类 型 的 传感器 : 


口 LIS331DLH 3-axis Accelerometer: 加 速度 传感器 ; 
AK8973 3-axis Magnetic field sensor: 磁场 传感器 ; 
AK8973 Temperature sensor: 温度 传感器 ; 
SFH7743 Proximity sensor: 邻近 度 传感器 ; 
Orientation sensor: 方位 传感器 ; 

LM3530 Light sensor: 亮度 传感器 。 





OOOOCDO 


8.1.4 指南 针 应 用 《〈 真 机 版 ) 








通常 由 传感器 所 传 回 的 数值 是 难以 被 用 户 直 接 所 理解 的 ， 就 连 温度 传感器 也 不 例外 。 
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虽然 温度 传感器 多 数 情况 下 仅仅 返回 一 个 代表 温度 的 数值 ， 但 是 倘若 不 告诉 用 户 该 温度 值 
所 使 用 的 单位 ， 一 样 是 难以 理解 的 。 因 此 ， 本 小 节 通 过 在 Android 上 实现 一 个 指南 针 的 应 
用 ， 来 讲解 如 何 将 传感器 的 数值 与 视觉 效果 结合 起 来 ， 达 到 便于 用 户 所 理解 的 效果 。 

1. 功能 说 明 

功能 很 简单 ， 即 在 界面 上 显示 一 个 有 指向 性 的 图 片 ， 并 且 使 其 标识 的 方向 与 地 球 磁极 
方向 一 致 ， 效 果 如 图 8.4 和 图 8.5 所 示 。 


甘 十 南 10:22 基 喇 和 3:17 
Sensorsimulator compass Sensorsimulator compass 











指南 针 指南 针 
图 8.4 指南 针 效 果 图 图 8.5 旋转 手机 后 的 一 个 状态 


如 上 两 幅 截图 分 别 代表 了 手机 的 两 个 不 同 朝向 的 状态 。 
2， 代码 实现 


结合 本 节 中 对 方位 传感器 的 相关 介绍 ， 结 合 图 8.2 所 示 的 坐标 系 ， 可 以 知道 在 这 个 指 
南 针 应 用 中 ， 需 要 关注 的 是 手机 绕 图 8.2 的 Z 轴 所 旋转 的 角度 ， 也 就 是 传感器 所 传 回 的 
values[0] 值 ， 该 values[0] 的 值 即 代表 了 手机 当前 已 经 绕 Z 轴 所 旋转 的 角度 ， 这 个 角度 以 正 
北方 向 为 基准 ， 其 返回 的 值 如 图 8.6 所 示 。 假 定 图 中 右 方 箭头 所 指 方向 为 正 北 ， 左 方圆 形 
中 的 箭头 所 指 的 是 手机 〈 传 感 器 ) 所 朝 的 方向 ， 数 值 则 是 传感器 返回 的 values[0] 值 。 











0 
正 北 
270 90 
180 
图 8.6 手机 朝向 与 传感器 返回 值 的 关系 
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知道 了 这 两 者 之 间 的 关系 ， 就 可 以 开始 实现 具体 的 代码 了 ， 首 先 需 要 从 方位 传感器 获 
取 其 感应 到 的 值 。 为 此 ， 首 先 需要 为 Activity 实现 SensorEventListener 接口 ， 即 在 类 中 实 
现 如 下 两 个 方法 : 

public void onAccuracyChanged (Sensor sensor, int accuracy) {} 

// 当 传感器 经 度 发 生变 化 时 被 调用 

public void onSensorChanged (SensorEvent event) {}// 当 传感器 值 发 生变 化 时 被 调用 

在 一 般 简 单 的 应 用 中 通常 将 onAccuracyChanged 方 法 留 空 ,主要 是 在 onSensorChanged() 
方法 中 去 实现 相应 的 功能 。 在 实现 了 SensorEventListener 接口 后 ， 才 能 够 获取 到 传感器 发 
生变 化 的 事件 ， 然 后 需要 为 当前 的 Activity 注册 需要 使 用 的 传感器 。 首 先 ， 需 要 通过 如 下 
的 方式 获取 到 系统 默认 的 方位 传感器 的 实例 : 

01 mSensorManager = (SensorManager)getSystemService (SENSOR SERVICE) 


// 获 取 SensorManager 实例 
02 morientation = mSensorManager.getDefaultSensor (Sensor.TYPE 
ORIENTATION); 

















// 获 取 方 位 传感器 实例 
然后 ， 需 要 完成 传感器 事件 监听 器 和 传感器 的 注册 工作 ， 只 有 注册 了 之 后 ， 传 感 器 管 
理 器 (SensorManager) 才 会 将 相应 的 传 感 信号 传 给 该 监听 器 。 通 常 将 这 个 注册 的 操作 放 在 
Activity 的 onResume() 方 法 下 ， 同 时 将 取消 注册 即 注销 的 操作 放 在 Activity 的 onPause() 方 
法 下 ， 这 样 就 可 以 使 传感器 的 资源 得 到 合理 的 使 用 和 释放 ， 方 法 如 下 : 


01 protected void onResume() { 


02 super.onResume (); 
03 // 注 册 传感器 事件 监听 器 ， 该 监听 器 用 于 监听 方位 传感器 的 变化 ， 监 听 频 率 为 适合 UI 
显示 的 频率 

04 mSensorManager .registerListener(this, mOrientation, Sensor- 
Manager .SENSOR DELAY UI); 

O05 站 

06 protected void onPause() { 

07 super.onPause (); 

08 mSensorManager .unregisterListener (this); // 解 除 监听 器 注册 

OS 


注册 了 对 方位 传感器 的 事件 监听 器 之 后 ， 当 方位 传感器 的 数值 发 生 改变 或 者 到 达 更 新 
数值 时 ，onSensorChanged() 方 法 就 将 被 执行 ， 同 时 还 会 传 入 一 个 包含 传感器 事件 信息 的 
SensorEvent 对 象 ， 根据 这 个 对 象 的 属性 就 可 以 获取 到 方位 值 了 ， 然 后 根据 这 个 方位 值 来 实 
现 对 指南 针 的 控制 。 

指南 针 使 用 一 个 ImageView 来 实现 ， 而 指南 针 的 旋转 则 使 用 了 RotateAnimation 类 ， 
这 个 类 专用 于 定义 旋转 图 像 的 操作 ， 它 的 一 个 构造 方法 如 下 : 

RotateAnimation (float fromDegrees, float toDegrees, int pivotxType, float 

pivotXValue, int pivotYType, float pivotYValue) 


构造 方法 中 包含 了 6 个 参数 ， 它 们 的 含义 分 别 如 下 : 

口 fromDegrees: 该 段 旋转 动画 的 起 始 度 数 。 

口 toDegrees: 旋转 的 终点 度数 。 

口 pivotXType: 这 个 参数 用 于 指定 其 后 的 pivotXValue 的 类 型 ， 即 说 明 按 何 种 规则 来 
解析 pivotXValue 数值 ， 目 前 包括 3 种 类 型 即 Animation.ABSOLUTE (绝对 数值 ， 
即 pivotXValue 为 坐标 值 )、AnimationRELATIVE TO_SELF (相对 于 自身 的 位 置 ， 
如 本 示例 中 的 ImageView， 当 pivotXValue 为 0.5 时 表示 旋转 的 轴 心 X 坐标 在 图 形 
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的 X 边 的 中 点 )、Animation RELATIVE TO PARENT (相对 于 父 视图 的 位 置 )。 
口 pivotXValue: 动画 旋转 的 轴 心 的 值 ， 对 它 的 解析 依赖 于 前 面 的 pivotXType 指定 的 类 型 。 
口 pivotYType: 类 似 于 pivotXType， 只 是 这 个 参数 代表 的 为 Y 轴 。 

口 pivotYValue: 类 似 于 pivotXValue， 只 是 这 个 参数 代表 的 为 Y 轴 。 
下 面 来 构造 本 例 中 的 RotateAnimation 对 象 ， 如 下 : 


01 RotateAnimation ra; 
02 ra = new RotateAnimation(currentDegree, targetDegree, 
// 实 例 化 旋转 动画 ， 该 动画 用 于 旋转 指南 针 
03 Rnimation .RELRTIVE TO SELF, 0.5f, 
04 Animation.RELATIVE TO SELF, 0.5f); 
05 ra.setDuration(200); // 在 200 毫秒 之 内 完成 旋转 动作 


如 上 述 代 码 ，02 一 04 行 定义 了 该 旋转 动画 的 属性 ， 即 以 执行 该 动画 的 对 象 的 正中 心 为 





旋转 轴 进 行 旋转 ; 


05 行 则 设 定 了 完成 整个 旋转 动作 的 时 间 。 有 了 这 个 ra 对 象 , ImageView 对 象 通过 方法 : 
ImageView.startAnimation (ra); // 执 行 旋转 动画 

就 可 以 执行 这 个 旋转 。 

最 后 还 需要 找 一 张 图 片 用 于 指定 各 个 方向 ， 为 了 美观 和 便于 使 用 ， 示 例 使 用 了 一 张 矩 


形 图 片 ， 便 于 自身 中 心 显得 对 称 ， 并 且 该 图 片 中 指示 北极 的 箭头 是 朝 下 上方 的 ， 即 可 以 设 
定 原始 图 片 的 旋转 度数 为 0， 如 果 原 始 图 片 的 北极 不 是 指向 正 上 方 也 可 以 使 用 ， 但 是 会 为 
之 后 的 编码 引入 领 外 的 工作 量 。 准 备 好 了 图 片 资源 ， 将 其 放 入 到 工程 的 drawable 目录 下 
并 在 Activity 的 onCreate() 方 法 中 绑 定 。 


传 





compass = (ImageView)findViewById(R.id.compass);// 关 联 ImageView 


现在 有 了 compass 这 个 ImageView， 就 只 需要 在 onSensorChanged() 方 法 中 通过 传感器 


回 的 数值 来 定义 出 需要 执行 的 RotateAnimation ra， 并 执行 compass.startAnimation(ra) 就 


可 以 实现 在 传感器 每 次 传 回 数值 时 对 指南 针 进 行 转动 ， 从 而 实现 了 指南 针 的 功能 。 
onSensorChanged() 的 完整 代码 如 下 : 





01 public void onSensorChanged (SensorEvent event) { 


02 Switch (event.sensor.getType()){ 
03 case Sensor.TYPE ORIENTATION: { 
// 如 果 新 的 传感器 变化 事件 来 自 于 方位 传感器 ， 则 执行 以 下 代码 
04 // 处 理 传感器 传 回 的 数值 并 反映 到 图 像 的 旋转 上 ， 
05 // 需 要 注意 的 是 由 于 指南 针 图 像 的 旋转 是 与 手机 〈 传 感 器 ) 相反 的 ， 
06 // 因 此 需要 旋转 的 角度 为 负 的 角度 (-event .values[0]) 
07 float targetDegree = -event.values[0]; 
08 rotateCompass (currentDegree, targetDegree); // 执 行 旋转 
09 currentDegree = targetDegree; // 保 存 当前 的 旋转 角度 
10 break; 
11 . 
12 default: 
3 break; 
14 #4 
5 
16 


17 // 以 指南 针 图 像 中心 为 轴 旋 转 ， 从 起 始 度 数 currentDegree 旋转 至 targetDegree 
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19 private void rotateCompass (float currentDegree, float targetDegree){ 


20 RotateAnimation ra; 

21 ra = new RotateAnimation(currentDegree, targetDegree, 

22 Animation.RELATIVE TO SELF, 0.5f, 

23 Animation.RELATIVE TO SELF, 0.5f); 

24 ra-setDuration(200) // 在 200 毫秒 之 内 完成 旋转 动作 
25 compass.startAnimation (ra); // 开 始 旋转 图 像 

之 后 下 


其 中 ，19 一 26 行将 执行 旋转 的 一 系列 步骤 提取 出 来 单独 列 为 了 一 个 子 程序 
rotateCompass(), 只 需要 提供 起 始 度 数 currentDegree 和 终止 度数 targetDegree 即 可 ; 另外 需 
要 注意 的 一 个 地 方 则 是 如 注释 04 一 06 行 所 述 的 需要 将 targetDegree 取 值 为 负 的 values[0]， 
这 里 也 进一步 说 明了 对 传感器 数值 的 利用 是 需要 进行 修饰 的 。 
读者 应 该 已 经 发 现 本 小 节 的 名 称 后 面 有 个 括号 的 内 容 是 “ 真 机 版 ” 那 是 不 是 说 明 该 
示例 还 有 一 个 模拟 器 版 本 呢 ? 没 错 ， 下 一 小 节 就 将 介绍 如 何在 模拟 器 上 来 调试 与 传感器 相 
关 的 应 用 程序 ， 读 者 可 能 会 有 疑问 ， 就 是 模拟 器 根本 就 不 存在 传感器 ， 怎 么 能 使 用 模拟 器 
来 调试 传感器 呢 ? 这 就 需要 借助 到 一 个 名 为 OpenIntents 的 开放 项 目 , 这 个 项 目下 有 一 个 名 
为 SensorSimulator 的 子 项 目 ， 从 名 称 中 就 可 以 看 出 ， 这 个 项 目 是 用 于 仿真 传感器 的 ， 借 助 
这 个 项 目 就 可 以 为 模拟 器 再 仿真 出 一 套 “ 模 拟 传感器 ” 就 可 以 实现 在 模拟 器 上 调试 与 传 感 
器 相关 的 应 用 了 ， 具 体 的 方法 将 在 下 一 小 节 里 进行 详细 的 说 明 。 











8.1.5 ”指南 针 应 用 (模拟 器 版 ) 


上 一 小 节 的 末尾 已 经 提 到 了 如 何在 模拟 器 上 开发 与 传感器 相关 应 用 的 方法 , 本 小 节 就 按 
照 这 个 方法 来 实现 指南 针 应 用 的 模拟 器 版 本 ， 首 先 介绍 一 下 SensorSimulator 及 其 使 用 方法 。 


1. SensorSimulator 下 载 


SensorSimulator 能 够 使 你 仅仅 通过 鼠标 和 键盘 就 能 够 实时 地 仿真 出 各 种 传感器 的 数 
据 ， 在 最 新 的 SensorSimulator 版 本 中 甚至 还 支持 了 仿真 电池 电量 状态 、 仿 真 GPS 位 置 的 
功能 ， 它 还 能 够 “录制 ” 真 机 的 传感器 在 一 段 时 间 内 的 变化 情况 ， 以 便于 为 开发 者 分 析 和 
测试 提供 材料 。OpenIntents 项 目的 下 载 地 址 在 http://code.google.com/p/openintents/ 
downloadsylist， 你 可 以 在 这 个 页 面 找到 所 有 OpenIntents 已 发 布 的 软件 包 ， 其 中 就 包括 了 
SensorSimulator， 目 前 的 版 本 号 为 2.0-rc1， 如 图 8.7 所 示 。 


C © code.google.com/p/openintents/do 


py openintents 


Make Android applications work together 





ProjectHome | Downloads | Wi lssues Source 




















Search | Currentdownloads & [=] for Search 
Filename v Summary * Labels v 
到] ShoppinaList14.1apk Ol Shopping List 14.1 Featured 
天 Shoppinglist-source-14.1.zip Ol Shopping List 1.4.1 (source code) 
[3) LendMe apk LendMe showcase app for Historiy 


图 8.7 在 何 处 下 载 SensorSimulator 
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下 载 并 解压 sensorsimulatorzip 包 后 ， 可 以 发 现 目录 下 的 结构 如 图 8.8 所 示 。 


是 bn 

恒 ib 

dent 

Bsamples 

Bl SensorRecordFromDevice 


BSensorSimulator 





Bl SensorSimulatorSettings 


readme.bt 2011/8/24 617 文本 文档 
图 8.8 sensorsimulator 包 的 内 容 


其 中 bin 文件 夹 下 包括 了 已 编译 好 的 一 个 可 执行 jar 文件 和 两 个 apk 安装 包 , 以 及 3 个 
用 于 描述 说 明 的 文本 文件 ; lib 文件 夹 下 则 是 编译 好 的 java 类 库 , 提供 与 传感器 仿真 有 关 的 
API; release 文件 夹 下 存放 的 是 用 于 build 发 布 版 的 代码 ，samples 文件 夹 下 提供 了 两 个 传 
感 器 的 示例 ; 第 5 一 第 7 个 文件 夹 则 是 该 bin 中 已 编译 的 二 进 制 文件 的 源码 。 对 于 本 例 来 
说 ， 需 要 使 用 到 的 只 有 bin 和 lib 两 个 文件 夹 中 的 内 容 。 

2. SensorSimulator 连 接 使 用 

为 了 使 Android 模拟 器 能 够 接收 到 SensorSimulator 所 仿真 出 的 传感器 数据 ， 首 先 需要 
做 的 是 让 模拟 器 能 够 与 SensorSimulator 建立 连接 ， 为 此 首先 需要 在 Android 模拟 器 上 安装 
SensorSimulatorSettings -2.0-rcl.apk 这 个 应 用 ， 通 常 在 命令 提示 符 下 输入 如 下 命令 : 

adb install SensorSimulatorSettings -2.0-rcl.apk 

// 快 速 地 将 位 于 PC 机 上 的 安装 文件 安装 到 已 连接 的 设备 上 

将 这 个 用 于 设置 连接 的 应 用 安装 到 模拟 器 中 后 ， 运 行 该 应 用 程序 会 进入 如 图 8.9、 图 

8.10 所 示 的 界面 。 





图 8.9 JP 和 端口 设置 界面 图 8.10 测试 连接 界面 





其 中 图 8.9 中 所 需要 填 的 他 地 址 及 socket 端口 号 就 是 模拟 器 与 SensorSimulator 连接 的 
凭据 ， 卫 地 址 可 以 直接 填写 10.0.2.2， 它 代表 了 运行 该 模拟 器 的 宿主 PC， 端 口号 则 需要 与 
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SensorSimulator 中 的 设置 一 致 ， 一 般 来 说 默认 即 可 ， 如 果 遇 到 端口 冲突 的 问题 ， 分 别 在 模 
拟 器 中 和 SensorSimulator 的 配置 中 ( 稍 后 会 进行 说 明 ) 进行 一 致 的 更 改 即 可 。 图 8.10 所 示 
的 为 测试 连接 的 界面 ， 虽 然 被 成 为 测试 界面 ， 但 是 实际 上 也 是 依靠 单 击 Connect 按钮 来 建 
立 好 连接 ， 连 接 成 功 之 后 才能 够 进一步 在 我 们 的 示例 中 成 功 地 接收 到 数据 。 

然后 在 PC 端 启动 bin 文件 夹 下 的 sensorsimulator-2.0-rcl.jar 这 个 可 执行 的 java 应 用 程 
序 ， 看 到 如 图 8.11 所 示 的 界面 。 


@ 面 


||® yaws ptcn © rolspicn © move (sensors | Scenaro Simulator | Quick Setinos | Sensors Parameters 
| 1 


Choose Device 
[Medium 加 


ons wants: 1000 masl 














accelerometer 0.00, 8.49, 4.90 
| magnetic field: 13.40, -27.66, -38.45 
ofientation: 340.00, -60.00, 0.00 

| light 400.00 

| gravity: 0.00, 8.49, 4.90 


| Write emulator command port and cick on set 
| to create connection. Possible IP addresses: 


10022 
192 168 1100 














Sensor Simulator 





图 8.11 SensorSimulator 界面 


如 图 所 示 ， 若 要 设置 端口 、 刷 新 频率 等 可 以 单 击 界面 右上 方 的 齿轮 样式 的 图 标 ， 界 面 
左边 一 栏 包括 了 3 个 窗口 ， 其 中 最 上 方 的 窗口 中 有 一 个 用 于 对 设备 的 方位 、 角 度 等 状态 进 
行 仿真 的 3D 模型 ， 可 以 使 用 鼠标 直接 对 该 模型 进行 yaw&pitch、roll&pitch 和 move 3 种 操 
作 ，3 种 操作 基本 可 以 模拟 出 绝 大 部 分 现实 世界 中 设备 的 各 种 状态 ， 对 于 3 种 操作 的 区 别 ， 
建议 读者 在 操作 中 体会 。 

中 间 的 窗口 中 的 一 系列 数据 就 是 最 上 方 窗口 中 的 模型 所 返回 的 传感器 数值 ， 默 认 地 开 
启 了 5 种 传感器 的 仿真 , 包括 accelerometer (加 速度 传感器 )、magnetic field (磁场 传感器 )、 
orientation( 方 位 传感器 ， 即 本 例 中 需要 使 用 到 的 传感器 )、light (亮度 传感器 ) 和 gravity 
(重力 传感器 )。 如 果 需 要 仿真 更 多 的 传感器 数据 ， 可 以 在 右边 一 栏 的 Sensors 选项 卡 中 进 
行 开 启 ， 如 图 中 显示 为 深 色 的 按钮 即 为 已 开启 的 传感器 类 型 ， 通 过 单 击 按钮 可 以 开启 /关闭 
相应 的 传感器 。 

最 下 方 的 窗口 则 是 一 个 作为 信息 输出 的 作用 。 界 面 右边 一 栏 包含 了 一 些 对 传感器 进行 
设置 或 者 控制 的 选项 ， 使 用 方法 比较 简单 ， 由 于 在 本 例 中 不 需要 进行 十 分 特定 的 仿真 ， 因 
此 不 必 关 注 其 他 的 内 容 ， 只 需要 保证 orientation 这 个 传感器 处 于 工作 状态 即 可 。 

在 确保 SensorSimulator 的 端口 号 与 模拟 器 上 设置 的 端口 号 一 致 后 (本 例 中 使 用 的 是 默 
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认 值 8010)， 在 模拟 器 的 Testing 选项 卡 下 单 击 Connect 按钮 ， 应 该 就 可 以 成 功 地 连接 至 
SensorSimulator 并 且 接 收 到 传感器 所 传 回 的 数据 了 , 如 图 
8.12 所 示 。 传感器 的 数据 将 会 显示 在 界面 的 下 半 部 分 , 五 
以 发 现 此 处 所 显示 的 数据 与 图 8.11 中 左边 一 栏 中 间 的 窗 
中 的 数据 相同 ， 通 过 鼠标 调整 3D 模型 的 状态 ， 可 以 发 















































纲 模拟 器 上 的 数据 与 之 发 生 同步 的 变化 , 这 就 说 明 模 拟 传 
感 器 的 连接 已 经 正确 地 建立 起 来 了 , 接 下 来 就 可 以 开始 利 
用 仿真 的 传感器 开发 应 用 程序 了 。 

3. SensorSimulator 模 拟 测试 


但 是 , 通过 如 上 一 系列 的 操作 之 后 并 不 能 使 原先 在 真 
机 上 可 以 工作 的 代码 直接 运行 起 来 ， 这 是 因为 通过 
SensorSimulator 模拟 出 来 的 传感器 并 不 能 直接 向 Android 
自 带 的 hardware 中 相关 的 API 传递 数据 , 因为 自 带 的 API 
是 需要 真 的 硬件 支持 的 。 不 过 ，SensorSimulator 很 优雅 地 
处 理 了 这 一 问题 , 它 通 过 提供 一 个 用 于 接收 其 仿真 出 来 的 。 图 8.12 连接 成 功 并 接收 到 数据 
传感器 的 API 类 库 ， 使 得 开发 者 可 以 通过 仅仅 替换 一 小 部 分 代码 即 可 使 得 程序 正常 运行 起 
来 ， 从 而 使 得 两 个 版 本 的 代码 直接 的 差异 性 达到 最 小 ， 下 面 介绍 如 何 对 真 机 版 的 代码 稍 作 
改变 使 其 能 够 运行 在 模拟 器 上 。 

(1) 加 载 感应 器 模拟 库 

首先 需要 在 Eclipse 项 目 中 加 入 lib 目录 下 的 sensorsimulator-lib-2.0-rcl.jar 包 ， 具 体 做 
法 是 用 鼠标 右键 单 击 项 目 名 称 ， 在 菜单 中 选择 Build Path|Configure Build Path... 命 令 ， 然后 
在 Libraries 选项 卡 下 单 击 Add Extemal JARs... 并 定位 到 sensorsimulator-lib-2.0-rcl.jar 文件 
即 可 ， 之 后 就 可 以 使 用 这 个 库 了 。 

(2) 引用 感应 器 模拟 包 

然后 在 项 目的 包 中 加 入 如 下 几 条 import: 


01 import org.openintents.sensorsimulator.hardware.Sensor; 

02 import org.openintents.sensorsimulator.hardware.SensorEvent; 

03 import org.openintents.sensorsimulator.hardware.SensorEventListener; 
04 import 
org.openintents.sensorsimulator.hardware.SensorManagerSimulator; 


需要 注意 的 是 ， 其 中 ，01 一 03 行 所 导入 的 类 与 原本 的 : 


import android.hardware.Sensor; 
import android.hardware.SensorEvent; 
import android.hardware.SensorEventListener; 


这 3 条 是 相 冲 突 的 ， 也 正 因 为 如 此 ， 模 拟 器 才能 够 接收 到 相应 的 数据 ， 而 新 导入 的 
SensorManagerSimulator 包 与 原 有 的 SensorManager 却 是 可 以 并 存 的 ， 也 可 以 说 
SensorManager 包 仍 然 是 新 版 本 项 目 所 需要 的 包 ， 这 是 因为 它 还 提供 了 可 供 使 用 的 一 些 具 
名 常量 。 因 此 ， 在 导入 了 4 个 新 的 类 之 后 ， 删 除 与 之 冲突 的 3 个 类 的 导入 就 可 以 了 。 

(3) 修改 AndroidManifest.xml 
日 于 手机 需要 通过 网 络 连接 到 SensorSimulator， 因 此 需要 在 AndroidManifestxml 加 入 
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对 网 络 的 使 用 权限 : 


<uses-permission 
android:name="android.permission.INTERNET"></uses-permission> 


// 需 要 网 络 访问 权限 


(4) 修改 代码 
另外 还 需要 替换 的 是 获取 SensorManager 实例 的 代码 ， 因 为 SensorManager 是 用 于 管 





理 传感器 的 , 而 原 有 的 获取 其 实例 的 方法 显然 是 不 能 够 是 用 于 仿真 出 来 的 传感器 的 , 因此 ， 
替换 ， 
mSensorManager = (SensorManager) getSystemService (SENSOR SERVICE) ; 
为 如 下 代码 : 
mSensorManager = SensorManagerSimulator.getSystemService (this, SENSOR_ 
SERVICE) ; // 获 取 模拟 服务 


从 而 获取 到 用 于 管理 仿真 出 来 的 传感器 的 SensorManager， 之 后 ， 还 需要 通过 如 下 方 
法 使 得 该 应 用 程序 连接 到 SensorSimulator: 
mSensorManager .connectSimulator (); // 连 接 到 仿真 器 


需要 注意 连接 成 功 的 条 件 是 正确 地 在 SensorSimulatorSettings 进行 了 成 功 的 连接 , 否则 
可 能 出 现在 项 目 中 不 能 够 获取 传感器 数据 的 情况 ， 如 果 遇 到 没有 反应 的 情况 ， 首 先 就 应 该 
去 检查 一 下 SensorSimulatorSettings。 

最 后 还 需要 一 项 极 小 的 改动 ， 由 于 所 有 传感器 都 是 仿真 出 来 的 ， 因 此 SensorSimulator 
所 提供 的 Sensor 类 就 没有 提供 getType() 方 法 ， 也 就 不 能 够 再 通过 event.sensor.getType0 的 
方式 来 获取 传感器 的 类 型 ， 而 是 使 用 event.type 的 方式 来 获取 。 

(5) 运行 测试 

经 过 如 上 所 述 的 几 步 简要 的 修改 后 ， 就 可 以 在 模拟 器 上 运行 该 示例 了 。 经 过 这 个 过 程 
我 们 可 以 发 现实 际 上 对 真正 实现 功能 逻辑 的 代码 并 没有 进行 改动 ， 因 此 也 说 明了 使 用 模拟 
器 开发 与 传感器 相关 的 应 用 是 可 行 的 。 在 本 章 随 后 的 章节 中 ， 如 没有 特殊 的 说 明 ， 开 发 过 
程 都 将 在 模拟 器 上 进行 。 下 面 通 过 截图 来 看 一 下 指南 针 应 用 的 模拟 器 版 本 的 运行 效果 ， 如 
图 8.13、 图 8.14 所 示 分 别 展 示 了 两 种 不 同 的 朝向 。 
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图 8.13 指南针 模 拟 状态 1 
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Sensor update: 1020 ms 


orientation 36.00, :24.00, -100 

















图 8.14 指南针 模 拟 状态 2 


8.1.6 计 步 器 应 用 


前 面 一 小 节 介 绍 了 如 何 借助 方位 传感器 来 实现 指南 针 功能 ， 并 且 进 一 步 说 明了 如 何 使 
用 模拟 器 来 开发 涉及 传感器 的 应 用 程序 。 不 过 前 面 一 小 节 实现 指南 针 功 能 时 对 数据 的 处 理 
相对 较 简单 ， 仅 需要 对 传感器 返回 的 值 取 负 值 即 可 ， 本 小 节 将 再 带领 大 家 实现 另 一 个 常用 
的 并 且 稍微 复杂 的 应 用 一 一 计 步 器 。 


1. 计 步 器 介绍 


什么 是 计 步 器 呢 ? 顾名思义 ， 计 步 器 就 是 用 于 计算 一 个 人 所 走 过 的 步 数 ， 市 面 上 销售 
的 一 些 计 步 器 往往 还 带 有 其 他 一 些 非常 丰富 的 功能 ， 如 估算 一 个 人 所 消耗 的 能 量 、 估 算 所 
走 过 的 距离 等 等 。 但 这 些 功 能 都 是 建立 在 准确 地 测定 了 人 所 走 的 步 数 之 上 的 ， 那 么 如 何 准 
确 地 测定 步 数 呢 ? 这 就 需要 借助 于 传感器 了 ， 如 何 处 理 、 统 计 传 感 器 的 数据 ， 就 决定 了 测 
定 步 数 的 准确 性 。Android 提供 了 众多 传感器 的 支持 ， 实 现 一 个 简易 的 计 步 器 当然 也 是 力 
所 能 及 的 了 。 下 面 就 在 Android 平台 上 来 实现 一 个 简易 的 计 步 器 应 用 。 


2. 计 步 功能 实现 分 析 


那么 ， 实 现 一 个 计 步 器 需要 使 用 什么 传感器 呢 ? 联想 一 下 ， 在 使 用 计 步 器 的 时 候 手机 
会 经 历 的 状态 一 一 人 往往 会 将 手机 置 于 衣物 的 口袋 或 者 背包 中 ， 而 人 在 步行 时 重心 会 有 一 
点 上 下 移动 (以 腰部 的 上 下 位 移 最 为 明显 ， 所 以 通常 推荐 将 计 步 器 挂 在 腰带 上 ， 而 对 于 手 
机 ， 自 然 就 建议 放 在 距离 腰部 附近 的 位 置 )。 

因此 ,我们 可 以 将 每 一 步 的 运动 简化 为 一 种 上 下 运动 。 这 时 候 SensorSimulator 就 能 
发 挥 作用 了 ， 打 开 SensorSimulator， 使 用 所 有 可 能 产生 反应 的 传感器 (一 些 传感器 ， 如 温 
度 传感器 、 压 力 传感器 、 亮 度 传感器 等 可 以 直接 排除 ) 将 这 种 运动 施加 到 SensorSimulator 
里 的 手机 模型 上 ， 然 后 观察 这 些 传感器 所 传 回 数值 的 变化 ， 可 以 发 现 其 中 Accelerometer 
和 Linear-accerleration 这 两 种 传感器 的 第 三 个 数值 变化 与 对 手机 施加 的 动作 之 间 有 着 相近 
的 频率 ， 再 结合 传感器 的 实际 功能 ， 就 可 以 确定 是 这 两 类 传感器 可 以 用 于 实现 计 步 器 的 
功能 。 
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而 Accelerometer 和 Linear-Accerleration 这 两 个 传感器 之 间 又 有 什么 样 的 关系 呢 ? 下 面 
简要 地 介绍 一 下 Accelerometer、Gravity 和 Linear-Accerleration 这 3 个 传感器 。 
(1) 加 速度 传感器 Accelerometer 
加 速度 传感器 所 测量 的 是 所 有 施加 在 设备 上 的 力 所 产 生 的 加 速度 (包括 了 重力 加 速 

















度 ) 的 负 值 (这 个 负 值 是 参照 图 8.1 的 世界 坐标 系 而 言 的 ， 因 为 默认 手机 的 朝向 是 向 上 ， 
而 重力 加 速度 则 朝 下 , 这 里 取 值 为 负 值 可 以 与 大 部 分 人 的 认 知 观念 相符 一 一 即 手机 朝 上 时 ， 
传感器 的 数值 为 正 )。 加 速度 所 使 用 的 单位 是 m/s* ,其 更 新 时 所 返回 的 SensorEvent.values[] 
数组 的 各 值 含义 分 别 为 : 








口 SensorEvent.values[0]: 加 速度 在 X 轴 的 负 值 。 
口 SensorEvent.values[1]: 加 速度 在 立轴 的 负 值 。 
口 SensorEvent.values[2]: 加 速度 在 Z 轴 的 负 值 。 
例如 : 
口 当 手 机 屏幕 朝 上 静止 地 放 在 水 平 桌面 上 (可 称 为 标准 姿态 )， 此 时 values[2] 的 值 将 
会 约 等 于 重力 加 速度 g (9.8nmys? )。 
口 车 手机 的 状态 不 是 标准 状态 ， 那 么 数组 values[] 的 值 分 别 为 重力 加 速度 在 各 方向 上 
的 分 量 。 
口 当 和 手机 以 标准 姿态 做 竖 直 的 自由 落体 运动 时 ， 此 时 各 方向 的 加 速度 将 为 0。 
口 当 手 机 向 上 以 2m/s? 的 加 速度 做 直线 运动 时 ，values[2] 的 值 为 11.8m/s? 。 
(2) 重力 加 速度 传感器 一 一 Gravity 
重力 加 速度 传感器 , 其 单位 也 是 m/s*， 其 坐标 系 与 加 速度 传感器 一 致 。 当 手机 静止 时 ， 
重力 加 速度 传感器 的 值 和 加 速度 传感器 的 值 是 一 致 的 ， 从 SensorSimulator 上 很 容易 观察 到 
这 一 点 。 
(3) 线性 加 速度 传感器 一 一 Linear-Acceleration 
这 个 传感器 所 传 回 的 数值 可 以 通过 如 下 一 个 公式 清楚 地 了 解 : 
accelerometer = gravity + linear-acceleration 
如 上 所 述 , 可 知 Accelerometer 和 Linear-Accerleration 这 两 类 传感器 在 本 例 中 几乎 可 以 
发 挥 相同 的 作用 ， 结 合 图 8.3 所 获取 的 一 款 真 机 的 传感器 列 EPET 
表 ， 发 现 该 款 真 机 仅 支 持 两 者 中 的 Accerlerometer， 可 以 略 TATE 
做 推断 Accerlerometer 可 能 是 较 Linear-Accerleration 更 为 普 
及 的 一 种 传感器 ， 因 此 本 例 中 决定 使 用 Accerlerometer 传 感 
器 来 实现 计 步 器 的 功能 。 其 实 ， 如 果 某 一 款 手机 不 支持 
Accerlerometer 而 是 支持 Linear-Accerleration 传感器 , 我 们 也 
可 以 通过 少量 的 修改 即 可 使 计 步 器 程序 变 为 使 用 
Linear-Accerleration 的 版 本 。 
3. 计 步 器 效果 
本 示例 的 运行 效果 如 图 8.15 所 示 。 


计 步 器 包括 了 几 个 按钮 用 于 基本 的 控制 操作 ， 即 分 别 为 pe 
开始 计 步 、 暂 停 计 步 、 继 续 计 步 、 清 零 步 数 4 个 操作 。 RD I 
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4. 代码 实现 


(1) 实现 判断 走 一 步 的 逻辑 

由 于 本 示例 是 在 模拟 器 上 完成 的 ， 所 以 我 们 对 走路 的 情景 做 了 简化 : 假定 在 走路 的 过 
程 中 手机 保持 在 标准 姿态 ， 即 如 图 8.15 的 状态 ,并 将 手机 的 运动 轨迹 简化 为 竖 直 方向 上 的 
来 回 运动 ， 那 么 这 时 候 加 速度 传感器 的 values[2] 值 将 会 随 着 每 一 步 的 动作 而 发 生 周期 性 的 
变化 。 因 此 ， 计 步 器 的 核心 逻辑 就 是 依据 values[2] 值 的 变化 来 判定 是 否 完成 了 走 一 步 的 动 
作 。 判 断 走 一 步 的 代码 如 下 : 

















01 Private static final float GRAVITY = 9.80665f; // 重 力 常量 

02 private static final float GRAVITY RANGE = 0.001f; // 计 步 判 断 阅 值 

03 // 存 储 走 一 步 的 过 程 中 传感器 传 回 值 的 数组 以 便于 分 析 

04 private ArrayList<Float> dataOfOneStep = new ArrayList<Float>(); 

其 中 ，01、02 行 代码 定义 了 两 个 常量 ，GRAVITY epee 而 
GRAVITY_RANGE 是 一 个 用 于 忽略 极 小 的 加 速度 变化 的 常量 ， 即 只 要 与 GRAVITY 值 相差 在 


该 值 的 范围 内 时 , 就 认为 还 是 处 于 标准 的 重力 加 速度 状态 下 ， i -种 “ 防 拌 动 ”措施 ; 
04 行 定义 了 一 个 ArrayList 类 型 的 对 象 dataOfOneStep， 用 于 存储 一 段 连续 的 传感器 数 
值 以 供 分 析 使 用 。 
完成 了 基本 数据 的 定义 之 后 , 我 们 实行 对 完成 一 步行 走 的 动作 判断 , 其 判断 实行 如 下 : 


01 WE 
02 * 判断 是 否 完成 了 一 步行 走 的 动作 
03 * @param newData 传感器 新 传 回 的 数值 (values [2]) 
04 * @return 是 否 完成 一 步 
05 */ 
06 Private boolean justFinishedOneStep (float newData){ 
07 boolean finishedoneStep = false; 
08 dataOfOneStep.add (newData) ; // 将 新 数据 加 入 到 用 于 存储 数据 的 列表 中 
09 dataOfOneStep = eliminateRedundancies (dataOfOneStep); 

// 消 除 元 余数 据 
10 finishedOneStep = analysisStepData (dataOfOneStep); 

// 分 析 是 否 完成 了 一 步 动 作 
11 if (finishedOoneStep){ 

// 若 分 析 结 果 为 完成 了 一 步 动 作 ， 则 清空 数组 ， 并 返回 真 

二 过 data0fOneStep.clear() 7 
13 return true; 
14 jelset // 若 分 析 结 果 为 尚未 完成 一 步 动作 , 则 返回 假 
5 if(dataOfOnestep.size() >= 100){ // 防 止 占用 资源 过 大 
16 dataOfOnesStep.clear (); 
dn 
18 return false; 
下 9 } 
20 } 


其 中 ，justFinishedOneStep0 方 法 用 于 根据 analysisStepData() 方 法 所 返回 的 值 来 进行 相 
应 的 事务 处 理 : 向 调用 方 返回 是 否 完成 一 步 ， 并 且 维 护 dataOfOneStep 的 数据 。 

在 行走 动作 判断 中 ， 我 们 调用 了 数据 分 析 方法 ， 该 方法 通过 搜集 的 手机 方向 变化 数据 
来 判断 是 否 完 成 了 一 步行 走 ， 具 体 实行 如 下 : 
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01 ss 

02 * 分 析 数 据 子 程序 

03 * Q@param stepData 待 分 析 的 数据 

04 * Q@return 分 析 结 果 

05 地 丰 

06 private boolean analysisStepData (ArrayList<Float> stepData){ 

07 boolean answerOfAnalysis = false;// 用 于 保存 分 析 结 果 

08 boolean dataHasBiggerValue = false; // 是 否 存在 一 个 极 大 值 

09 boolean dataHasSmallerValue = false; // 是 否 存在 一 个 极 小 值 

10 for (int i=1l; i<stepData.size()-1; i++){ 

4 IE(stePData.get(I) .floatValue() > GRAVITY + GRAVITY 

RANGE) { // 是 否 存在 一 个 极 大 值 
2 if((stepData.get(i).floatValue() > stepData.get(i+1). 
floatValue()) &ES 
3 (stepData.get(i).floatValue() > stepData. 
get(i-1) .floatValue())){ 

14 dataHasBiggerValue = true; // 存 在 一 个 极 大 值 

15 } 

16 } 

17 if(stepData.get (i) .floatValue() < GRAVITY - GRAVITY 
RANGE) { // 是 否 存在 一 个 极 小 值 

18 if((stepData.get(i).floatValue() < stepData.get(i+1). 

floatValue()) && 
19 (stepData.get (i).floatValue() < stepData. 
get(i-1) .floatValue())){ 

20 dataHasSmallerValue = true; // 存 在 一 个 极 小 值 

2 } 

22 } 

23 } 

24 answerOfAnalysis = dataHasBiggerValue && dataHasSmaller- 

Value; // 得 出 最 终 分 析 结 果 
25 return answerOfAnalysis; 
26 } 


其 中 ，analysisStepData() 方 法 用 于 分 析 当 前 的 dataOfOneStep 列表 中 的 数据 是 否 被 判别 
为 完成 了 一 步 的 动作 ， 若 分 析 结 果 判 定 刚 完 成 了 一 步 ， 则 返回 真 ， 反 之 返回 假 。 

在 进行 数据 分 析 之 前 ， 我 们 需要 对 收集 到 的 所 有 数据 进行 去 除 元 余 ， 这 样 可 以 在 不 对 
结果 造成 实质 影响 的 情况 下 ， 节 省 空间 、 提 高 效率 。 具 体 的 去 除 元 余数 据 的 实现 如 下 : 








01 J 
02 * 消除 ArrayList 中 的 元 余数 据 ， 节 省 空间 ， 降 低 干 扰 
03 * @param rawData 原始 数据 
04 * @return 处 理 后 的 数据 
05 */ 
06 private ArrayList<Float> eliminateRedundancies (ArrayList 
<Float> rawData){ 
07 forl(int i=0; i<rawData.size()-1 ;i++){ 
08 if((rawData.get(i) < GRAVITY + GRAVITY RANGE) && 
(rawData.get(i) > GRAVITY 一 
09 GRAVITY RANGE) 
10 && (rawData.get(i+1) < GRAVITY + GRAVITY RANGE) && 
(rawData.get (i+1) > 
了 GRAVITY - GRAVITY RANGE) ) { 
// 如 果 数 据 与 重力 加 速度 差 值 在 阔 值 以 内 
12 rawData.remove (i); // 删 除 该 条 数据 
.3 }elsef{ 
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14 
15 
16 
17 
18 


break; 
} 
} 
return rawData; 


上 


其 中 ，eliminateRedundancies() 方 法 的 作用 是 消除 列表 dataOfOneStep 中 宛 余 的 数据 ， 


具体 做 法 是 从 列表 中 移 除 列表 前 端的 











EE 复 数据 ， 这 些 重复 数据 产生 的 原因 是 一 段 时 间 内 没 








有 进行 任何 动作 ， 使 得 传感器 按 一 定 频 率 传 回 大 量 与 GRAVITY 相近 的 数值 ， 该 方法 是 为 
了 防止 dataOfOneStep 的 数据 量变 得 过 大 。 上 述 代码 一 共 实 现 了 用 于 判断 一 步 的 3 个 方 


法 ， 即 : 





private boolean justFinishedOneStep (float newData) 
private boolean analysisStepData (ArrayList<Float> stepData) 
private ArrayList<Float> eliminateRedundancies (ArrayList<Float> rawData) 


其 中 的 调用 关系 为 justFinishedOneStep() 一 analysisStepData() 一 eliminate- 
Redundancies()。 有 了 如 上 所 述 的 判断 逻辑 之 后 ， 就 可 以 进一步 实现 计 步 器 了 。 
(2) 注册 和 使 用 加 速度 传感器 。 


代码 如 下 : 
01 private SensorManagerSimulator mSensorManager; // 传 感 器 管理 器 
02 private Sensor mAccelerometer; // 加 速度 传感器 
03 @Override 
04 Public void onCreate (Bundle savedInstanceState) { 
05 super.onCreate (savedInstanceState) 
06 setContentView(R.layout.main);  // 绑 定 layout 布局 
07 stepcount = (TextView) findViewById(R.id.stepcount) 
// 绑 定 TextView， 用 于 显示 已 计 步 数 
08 debug = (TextView) findViewById(R.id.debug) 
// 绑 定 TextView， 用 于 显示 调试 信息 
09 // 获 取 仿 真 版 传感器 管理 器 对 象 
10 mSensorManager = SensorManagerSimulator.getSystemService (this， 
SENSOR SERVICE); 
11 // 获 取 仿 真 版 加 速度 传感器 对 象 
12 mAccelerometer = mSensorManager.getDefaultSensor (Sensor. 
TYPE ACCELEROMETER); 
13 mSensorManager .connectSimulator (); // 连 接 到 仿真 器 
14 } 
15 Protected void onResume() { 
16 super.onResume (); 
1 // 在 Activity 继续 执行 时 注册 传感器 监听 器 
19 mSensorManager .registerListener (this, mAccelerometer, Sensor- 
Manager .SENSOR DELAY UI); 
20 } 局 
2 
22 Protected void onPause() { 
23 super.onPause(); 
24 // 在 Activity 被 暂停 时 结束 传感器 监听 器 的 注册 
25 mSensorManager .unregisterListener (this); 
26 } 


获取 传感器 管理 器 对 象 、 连 接 仿真 器 、 注 册 和 注销 传感器 等 操作 与 前 面 指南 针 实 现 的 
相关 操作 类 似 。 
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(3) 将 计 步 结果 显示 到 用 户 界 面 


代码 如 下 : 
01 public void onSensorChanged (SensorEvent event) { 
02 Switch (event .type){ 
03 case Sensor.TYPE ACCELEROMETER:{ // 当 前 的 传感器 时 间 由 加 速度 传感器 产生 
04 Log.v(TAG, "values[0]-->" + event.values[0] + ", 
values[1]-->" + event.values[1] + ", 
05 values[2]-->" + event.values[2]); 
// 在 LogCcat 中 输出 调试 信息 
06 debug.setText ("values[0]-->" + event.values[0] + " 
\nvalues[1]-->" + event.values[1] + 
07 "\nvalues[2]-->" + event.values[2]); 
// 在 TextView 上 显示 debug 信息 
08 if(justFinishedOneStep (event.values[2]))1{ 
// 判 断 是 否 发 生 了 走 一 步 事件 
09 // 更 新 计 步 显示 
10 stepcount .setText ( (Integer.ParseInt(stepcount. 
gotText()-. toString()) 1 IE 7 
LE: } 
12 break; 
13 } 
14 default: 
15 break; 
16 下 
多 } 


显示 结果 的 代码 包含 在 传感器 的 回调 方法 onSensorChanged0 中 。 其中, 08 一 10 行 是 根 
据 对 传感器 传 回 数据 的 分 析 结 果 ， 来 判断 是 否 给 计 步 数 加 1。 到 此 为 止 ， 就 实现 了 一 个 简 
易 的 计 步 器 应 用 。 


5. 其 他 说 明 


本 示例 是 为 了 方便 说 明 传感器 的 使 用 而 建立 的 ， 因 此 在 实际 使 用 时 可 能 会 存在 误差 或 
者 失效 ， 因 为 计 步 这 个 看 似 简单 的 功能 ， 如 果 要 做 到 非常 精确 ， 需 要 进行 大 量 的 数据 统计 
和 分 析 ， 从 中 得 出 人 们 行走 的 特点 ， 才 能 够 准确 地 测量 出 步 数 ， 这 不 在 本 书 的 讨论 范围 之 
内 ， 如 果 读 者 有 兴趣 ， 不 妨 进行 更 深入 的 研究 。 


8.2 GPS 应 用 


GPS (Global Positioning System， 即 全 球 定位 系统 ) 从 最 早 的 用 于 军事 用 途 ， 现 在 已 
经 越 来 越 广泛 地 应 用 在 了 个 人 用 途上 ， 如 常见 的 车 载 GPS 导航 仪 、 智 能 手机 上 的 GPS 应 
用 等 等 。GPS 定位 是 基于 卫星 的 ， 因 此 又 被 称 为 全 球 卫 星 定 位 系统 ， 用 于 GPS 的 卫星 通常 
运行 在 中 距离 的 圆 形 轨道 上 ， 它 可 以 为 地 球 表面 绝 大 部 分 地 区 提供 准确 的 定位 、 测 速 和 高 
精度 的 时 间 标 准 。 

于 GPS 的 实用 性 ， 越 来 越 多 的 智能 手机 开始 支持 GPS，Android 也 不 例外 。GPS 几 
乎 是 每 个 搭载 Android 平台 的 手机 的 必 备 功能 ， 再 加 上 Google 所 拥有 的 极其 丰富 的 地 图 、 
卫星 图 像 、 街 景 图 像 等 资源 ， 可 以 说 在 Android 上 开发 与 地 理 信 息 结合 的 应 用 拥有 着 其 他 
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平台 无 可 比拟 的 优势 。 本 节 就 将 和 大 家 一 起 来 学 习 如 何在 Android 上 开发 与 GPS 相关 的 
应 用 。 





8.2.1 GPS 位 置 获取 


如 同 8.1 节 所 介绍 的 传感器 传 回 数值 一 样 ，GPS 的 最 核心 的 数据 就 是 依据 卫星 所 确定 
的 经 纬度 数据 ， 然 而 仅仅 得 到 一 个 经 纬度 的 数据 并 不 能 够 直观 地 表现 为 “位 置 ” 必须 结合 
地 图 才能 够 将 经 纬 数 值 代表 的 地 点 标示 出 来 ,因此 , 首先 介绍 如 何在 Android 中 使 用 Google 
Map 。 


1.， Google APls 安 装 


首先 , 需要 在 SDK Manager 中 下 载 使 用 Google Map 的 API 包 ,这 个 API 包 是 由 Google 
提供 的 第 三 方 开发 工具 包 ， 目 前 这 个 包 主 要 用 于 开发 包含 地 图 的 应 用 程序 。 这 个 包 必 须 结 
合 相 同 API Level 的 SDK Platform 使 用 ， 为 此 ， 在 SDK Manager 中 确保 下 载 好 一 套 SDK 
Platform + Google APIs， 如 图 8.16 所 示 。 


Packages Tools 
SDK Path: Di\study\programfiles\android-sdk-windows 
Packages 
前 Name Status 
4 回国 Android 3.2 (API13) 
回 党 SDK platform 寺 Installed 
回 @ Samples for SDK 志 Installed 
国 钨 Android 3.1 (API 12) 
回国 Android 3.0 (API 11) 
4 回国 Android 2.3,3 (API10) 
团 知 SDK platform 其 Installed 
回 @ Samples for SDK 志 Installed 
回 蜂 Google APis by Google inc. 
4 固 国 Android 2.2 (API 8) 
国营 SDK Platform 2 量 Update available: rev. 3 
回 @ Samples for SDK 1 和 赵 Installed 


Show: 园 Updates/New 同 Installed 同 Obsolete Select New/Updates Install 3 packages. 


Sort by: 回 ApIlevel © Repository Deselect All Delete 5 packages. 


| 





Downloading SDK Platform Android 2.2, API 8, revision 3 (79%, 82 KiB/s, 3 minutes lefd) 





图 8.16 下 载 Google APIs 


下 载 完 成 之 后 ， 在 AVD Manager 中 新 建 AVD 时 ， 就 可 以 选择 新 建 支持 Google APIs 
的 模拟 器 了 ， 如 图 8.17， 建 立 一 个 支持 Google APIs 的 模拟 器 供 之 后 使 用 。 在 新 建 项 目 时 
的 Select Build Target 页 面 中 也 会 出 现 相应 Google APIs 的 选项 ， 如 果 新 建 的 项 目 是 与 地 图 
相关 的 ， 那 么 就 需要 选择 Google APIs 作为 Build Target， 如 图 8.18 所 示 。 


2. Google APls 文 档 


下 载 好 的 Google APIs 可 以 在 <android-sdk>/add-ons 目录 下 找到 , 这 个 目录 下 存放 的 是 
不 属于 标准 的 Platform SDK 的 、 由 第 三 方 提供 的 API， 如 果 已 经 在 前 面 所 说 的 步骤 中 正确 
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地 安装 了 GoogleAPIs， 就 可 以 在 该 目录 下 找到 类 似 addon google apis google inc 10 的 目 
录 ， 该 目录 下 包括 了 为 模拟 器 所 使 用 的 已 编译 镜像 、API 类 库 、 示 例 和 API 文档 ， 对 我 们 
最 有 用 的 就 是 位 于 docs 目录 下 的 开发 文档 了 ， 用 浏览 器 打开 docs/ reference/index.html 文 
件 就 可 以 看 到 相关 的 API 文档 ， 如 图 8.19 所 示 。 



































Create newAndroidVitualDevice (AVD) | New Anaroid project IETEST 
ES Select Build Target 
Choose an SDK to target 
Target: 
Android 2.2 - API Level 8 BuidT 
| CPU/ABE Android 233 - Apltevel lo sy 
SD Card: Android 3.2 - API Level 13 Target Name Vendor Platform 。 API … 
Android 40 - API Level 14 回 Android 22 Android Open Source Project 22 8 
| :一 一 一 固 Android 23.3 Android Open Source project 2.3.3 10 
File: Br 圆 Google APls Google Inc. 2.3.3 10 
| 回 Android 32 Android Open Source Project 32 13 
SR Android 40 Android Open Source Project 40 14 
口 Enabled 
图 8.17 创建 AVD 时 选择 Google APIs 图 8.18 创建 项 目 时 选择 Google APIs 作为 Build Target 





© © filey///D:/study/programfiles/android-sdk-windows/add-ons/addon_google_apis_google_inc_10/docs/reference/index.html 


AllClasses 


GeoPoint Package Class Tree Deprecated Index Help 
GeoPoint PREV PACKAGE NEXT PACKAGE ERAMES NOFRAMES 
ltemizedOverlay 
ltemizedOverlay 
ltemlzedOveriay. OnFocusChangeListenel 和 

NO | Package com.google.android.maps 
MapActvity iicati i 

一 The maps package allows applications to display and control a Google Map interface. 

MapView See: 
MapView Description 
MapView LayoutParams 


图 8.19 ”Google APIs 开发 文档 


通过 阅读 该 开发 文档 并 结合 其 提供 的 sample 可 以 很 快 地 入 门 。 下 面 一 起 来 建立 并 运行 
Google APIs 自 带 的 示例 。 


3. 运行 示例 


通过 单 击 File[New|Android ProjectlCreate project from existing samplelGoogle APIs| 
MapsDemolFinish 命令 ， 完 成 项 目的 创建 , 然后 直接 作为 Android Application 运行 ,模拟 器 
会 出 现 如 图 8.20 所 示 的 界面 ， 可 以 看 到 这 是 一 个 有 两 个 选项 的 列表 ， 每 一 项 对 应 了 一 个 
Activity。 

其 中 ， 第 一 个 Activity 即 MapViewDemo 实现 的 功能 是 显示 一 个 MapView (内容 显 示 
为 Google 提供 的 在 线 地 图 );， 第 二 个 Activity MapViewCompassDemo 实现 的 功能 是 一 个 带 
指南 针 功能 的 地 图 。 此 处 只 需要 看 第 一 个 示例 的 功能 ， 单 击 MapViewDemo 行将 会 跳 转 进 
入 一 个 新 的 界面 ， 然 而 ， 这 个 界面 中 并 没有 出 现 我 们 希望 见 到 的 地 图 ， 如 图 8.21 所 示 。 

这 是 为 什么 呢 ? 难道 官方 所 提供 的 这 个 示例 存在 错误 吗 ? 其 实 不 是 的 ， 出 于 某 些 原因 
(如 防止 Google 地 图 的 API 被 小 用)，Goosgle 要 求 每 一 个 使 用 该 API 的 产品 必须 申请 一 个 
唯一 的 API key 作为 凭证 ， 这 个 API key 是 根据 开发 者 所 使 用 的 计算 机 的 “指纹 ”来 确定 
的 ， 所 以 每 一 台 计 算 机 会 分 配 到 一 个 唯一 的 API key， 这 个 API key 需要 在 MapView 的 
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android:apiKey 属性 中 进行 指定 ， 对 于 此 处 的 MapsDemo 示例 ， 则 是 在 res/layout/ 
mapview.xml 文件 中 进行 指定 ，mapview.xml 的 代码 如 下 ， 其 中 字体 加 粗 的 一 行 即 为 需要 填 
入 APIkey 的 地 方 ，API key 的 申请 将 在 下 一 步 中 进行 说 明 。 


| | 
REED ww 


MapView 


MapView and Compass 





图 8.20 MapsDemo 启动 界面 图 8.21 空白 的 MapView 


01 <LinearLayout xmlns:android="http://schemas.android.com/apk/ 


res/android" 
02 android:id="@+id/main" 
03 android:layout width="match parent" 
04 android:layout height="match parent"> 
05 <com.google.android.maps.MapView 
06 android:layout width="match parent" 
07 android:layout height="match parent" 
08 android:enabled="true" 
09 android:clickable="true" 
10 android:apiKey="apisamples" 

// 此 处 的 apisamples 需要 更 换 为 申请 到 的 API Key 

下 了 /> 


12 </LinearLayout> 


4. 获取 Google Maps API Key 


申请 API Key 的 地 址 在 http://code.google.com/intl/zh-cn/android/maps-api-signup.html， 
地 址 可 能 会 变化 ， 用 Google 搜索 Android Maps API Key 即 可 ， 有 具体 的 步骤 如 下 : 

口 获取 计算 机 的 唯一 MD5 码 ， 又 称 “ 认 证 指纹 ”。 

口 API key 是 与 Google 账户 相关 联 的 ， 因 此 要 注册 Google 账号 。 

口 到 前 面 提供 的 网 址 提交 该 MD5 码 ， 获 取 API key。 

下 面 结合 图 例 来 具体 的 进行 说 明 。 

(1) 进入 命令 提示 符 

首先 打开 命令 提示 符 ， 并 定位 至 你 机 器 上 安装 的 Java 的 路 径 下 的 jre6\bin， 因 为 在 该 
目录 下 有 用 于 生成 认证 指纹 的 工具 keytool.exe， 如 图 8.22 所 示 。 
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(2) 复制 keystore 路 径 

在 输入 命令 之 前 , 先 需 要 获取 到 本 机 的 keystore 
文件 的 路 径 ， 该 文件 也 将 成 为 生成 认证 指纹 的 一 个 : an 
依据 ,keystore 文件 路 径 可 以 在 Eclipse 的 Preferences a 2 
可 区 ， 依次 单 击 Window|Preferences|Android|Build 
命令 ， 如 图 8.23 所 示 。 复 制 Default debug keystore 
对 应 该 内 容 即 debug keystore 文件 的 绝 ” 图 8.22 在 命令 提示 名 
对 路 








中 定位 至 jre6\bin 














Preferences rep 
type fiker text Build Or = 到 
onl Build Settings: 
Android > 
a 司 Automatically refresh Resources and Assets folder on build 
a J Force error when extermal jars contein native lbraries 
Ed Build output 
End Silent 
LogCat Normal 
Usage Stats Verbose 
Ant 
a Default debug keystore: Ci\Users\Honson\.android\debug.keystore 
InstalyUpdate Custom debug keystore: Browse,.. 
Java 
Maven 
Run/Debug 


图 8.23 获取 debug.keystore 的 路 径 


(3) 生成 认证 指纹 

回 到 第 一 步 的 命令 提示 符 下 ， 输 入 : 

keytool -list -alias androiddebugkey -keystore "C:\User\Honson\.android\debug. 

keystore" -storepass android -keypass android 

其 中 ， 黑 体 部 分 需要 替换 成 第 二 步 中 得 到 的 内 容 ， 后 面 的 -storepass android -keypass 
android 是 设置 密码 的 参数 ， 可 以 任意 填写 。 按 回 车 键 后 ， 将 会 得 到 “认证 指纹 ”如 图 8.24 
所 示 。 每 台电 脑 的 认证 指纹 码 都 是 唯一 的 ， 复 制 该 串 数 据 (此 处 是 
C3:55:9D:08:89:2F:B6:A7:9D:26:5D:09:8C:D1:73:B5) 备用 。 





ava\jre6 \hin>keyt st -a droiddebug 
id\debug.keyst s android -ke 
9- PrivateKeyEntr 





图 8.24 得 到 认证 指纹 


(4) 生成 APIKey 
进入 http://code.google.com/intl/zh-cn/android/maps-api-signup.html 页 面 , 如 图 8.25 所 示 ， 
在 My certificate's MD5 fingerprint 的 文本 框 里 填 入 在 第 三 步 中 得 到 的 认证 指纹 (MD5) 码 ， 
然后 单 击 Generate API Key 按钮 。 

如 果 没 有 登录 Google 账户 ， 则 会 提示 登录 账户 后 再 进行 操作 ， 如 果 你 没有 Google 账 
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户 就 需要 先 申请 一 个 ， 如 图 8.26 所 示 。 





Sign in with your 
Google Account 
1. Your relationship with Google. 4 Email 
ex pat@example. com 
Password 


国 1have read and agree with the terms and conditions (printable version) 
Stay signed in 


My certificate's MDS fingerprint: [C3:55-9D:08:89:2F:B6-A7:9D:26:5D:09:8C:D1:73:B5 
Cant access your account? 
图 8.25 填 入 认证 指纹 码 图 8.26 登录 Google 账户 


(5) APIKey 获取 成 功 
如 果 已 经 登录 了 Google 账户 ， 单 击 Generate API Key 按钮 后 就 将 得 到 自己 的 API Key 


了 ,在 进入 的 页 面 中 还 简要 地 介绍 了 如 何 使 用 API Key， 即 将 该 API Key 作为 MapView 的 
android:apiKey 属性 的 值 ， 如 图 8.27 所 示 。 


Google 地 图 APlL 


Google 代码 主页 > Google 地 图 API > Google 地 图 API 注册 





而 禾 注 册 Android 地 图 AP 二 外 
您 的 密 钥 是 : 
0k-swCMzyRu2-B-mdTbRRQzbbR6rcvHYB3ITmbw 
此 密 角 适用 于 所 有 使 用 以 下 指纹 所 对 应 证 书 进行 验证 的 应 用 程序 : 
C3:55:9D:08:89:2F:B6:A7:9D:26:5D:09:8C:D1:73:B5 
下 面 是 一 个 xml 格式 的 示例 ， 帮助 您 了 解 地 图 功能 : 


<com.google.android,maps.MapView 
android:layout_ width="fill parent" 
android:layourt_ height="fill parent" 
android:apiKey="0k-swCMzyAu2-B-mdTDRRQzbbRErcvHYB3J7mbw" 
/> 


有 关 详 细 信 息 ， 请 查看 AP 文档. 


图 8.27 注册 API Key 成 功 





需要 注意 的 是 ， 该 API Key 只 适用 于 当前 用 于 申请 的 计算 机 ， 如 果 你 的 开发 工作 转移 
到 了 另 一 台 计 算 机 上 , 那么 仍然 会 出 现 如 图 8.21 的 空白 MapView, 此 时 就 需要 重新 申请 一 
个 APIKey。 通 常 当 你 在 自己 开发 的 应 用 中 发 现 MapView 是 空白 时 ， 排 除了 网 络 的 原因 ， 
那么 很 大 的 可 能 就 是 因为 使 用 了 不 配套 的 API Key 所 致 。 

另外 ， 由 于 前 面 申请 的 API Key 是 根据 debug keystore 生成 的 ， 因 此 该 API Key 也 只 
适用 于 开发 测试 , 如 果 要 正式 发 布 应 用 则 须 首先 生成 一 个 非 测试 的 keystore, 然后 获取 API 
Key， 非 测试 的 keystore 可 以 使 用 eclipse 生成 。 


5. 修改 示例 ， 使 地 图 能 够 正确 显示 
打开 mapviewxml， 并 将 申请 的 API Key 填 入 android:apiKey， 修 改 后 的 代码 如 下 : 


01 <com.google.android.maps.MapView 
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6. 重新 运行 示例 


修改 了 API Key 之 后 , 重新 运行 MapsDemo, 可 以 看 
到 已 经 能 够 正常 地 显示 出 地 图 了 ， 如 图 8.28 所 示 。 


7. 为 示例 增加 GPS 位 置 获取 功能 


经 过 前 面相 应 的 修改 之 后 ，MapView 已 经 能 够 正确 
地 显示 出 地 图 ， 有 了 地 图 的 显示 就 能 够 将 获取 的 GPS 数 
据 直 观 地 反映 到 视图 上 去 了 。 接 下 来 为 示例 增加 GPS 位 
置 获取 的 功能 。 

(1) 实现 LocationListener 接口 


android:layout width="match parent" 

android:layout height="match parent" 
android:enabled="true" 

android:clickable="true" 
android:apiKey="0k-swCMzyAuOtDwVytvRtZi5--YM34YpwGVyq1Q" 
/> 





~ 
» 

那么 如 何 才能 够 获取 由 GPS 模块 所 获取 的 GPS 数据 4 局 
呢 ? 这 就 需要 一 个 实现 了 LocationListener 接口 的 类 ， Se* 


LocationListener 接口 的 onLocationChanged() 方 法 将 会 在 


图 8.28 正确 显示 出 地 网 


GPS 模块 传 回 新 的 数值 时 被 回调 ， 并 将 新 的 GPS 数据 作 
为 参数 传 入 。LocationListener 接口 所 包含 的 方法 如 下 : 


public abstract void onLocationChanged (Location location); 


// 当 地 点 发 生 改 变 时 被 调用 


public abstract void onProviderDisabled (String provider); 


// 当 GPS 的 provider 被 禁用 时 被 调用 


public abstract void onProviderEnabled (String provider); // 与 上 一 方法 相反 
public abstract void onStatusChanged (String provider, int status, Bundle 


extras); // 当 GPS 状态 发 生 改变 时 被 调用 

为 此 ， 新 建 一 个 名 为 MyLocationListener 的 类 并 使 其 实现 LocationListener 接口 ， 该 类 
的 功能 是 当 GPS 数据 更 新 时 ， 在 手机 界面 上 显示 一 个 Toast 消息 框 ， 消 息 内 容 为 新 的 位 置 
经 纬度 ， 并 且 将 地 图 定位 至 新 的 GPS 数据 所 代表 的 地 点 。 代 码 如 下 : 


01 public class MyLocationListener implements LocationListener 


02 
03 
04 
05 


06 
07 


08 
09 
10 
2 
13 
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private Context context; 
private MapView mapView; 
private MapController mapController; 
// 地 图 控制 器 对 象 ， 可 用 于 控制 地 图 缩放 ， 平 移 等 

// 构 造 方法 
public MyLocationListener (Context context, MapView mapView, 
MapController mapController){ 

this.context = context; 

this.mapView = mapView; 

this.mapController = mapController; 


} 


Q@Override 
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14 public void onLocationChanged(Location loc) { 
// 当 地 点 信息 发 生变 化 时 ， 该 方法 将 被 调用 

5 TEV (oC WM molLLy ot 

// 如 果 新 的 位 置信 息 不 为 nul11， 则 根据 传 入 的 位 置信 息 ， 生 成 GeoPoint 对 象 
16 GeoPoint nowAt = new GeoPoint((int) (Loc.getLatitude ()*le6) ， 

(int) (loc.getLongitude()*1e6)); 
17 mapController .animateTo (nowAt); // 平 移 到 新 的 位 置 处 
18 Toast.makeText (context， // 使 用 Toast 消息 显示 新 位 置 的 经 纬度 信息 
19 "位 置 改变 : 纬度 : " + loc.getLatitude() + 
20 " 经 度 : " + loc.getLongitude()， 
2 Toast.LENGTH SHORT) .show(); 
BP mapView.invalidate(); 
23 } 
24 } 
之 3 @Override 
26 public void onProviderDisabled(String provider) {} 
2 @Override 
28 public void onProviderEnabled (String provider) {} 
4 @Override 
30 public void onStatusChanged (String provider, int status, Bundle 


extras) {} 
31 3} 
其 中 ，07 行 MyLocationListener 的 构造 方法 需要 传 入 应 用 上 下 文 context、 需 要 更 新 的 
mapView 以 及 控制 mapView 更 新 的 mapController 作为 参数 ; 
16、17 行 的 作用 是 获取 新 的 GPS 位 置 数据 ,并 使 mnapView 的 中 心 点 移 至 新 的 GPS 位 置 ; 
18 一 21 行 则 是 用 于 显示 一 条 包含 新 的 经 纬度 信息 的 Toast 消息 ; 
22 行 用 于 即时 刷新 mapView。 
(2) 在 MapViewDemo 中 注册 MyLocationListener 
在 上 一 步 中 已 经 实现 了 MyLocationListener， 通 过 它 就 能 够 监听 到 GPS 数据 的 改变 ， 
要 使 用 监听 器 ， 则 需要 在 MapViewDemo 这 个 Activity 里 对 该 监听 器 进行 注册 ， 注 册 监 听 
器 通过 LocationManager 完成 ， 监 听 器 注册 成 功 后 ，Activity 就 能 够 按 一 定 的 频率 接收 到 位 
置 的 改变 。 代 码 如 下 : 
01 ， context = getBaseContext () ;// 获 取 应 用 程序 上 下 文 环境 
02 ”// 获 取 位 置 管理 器 
03 locationManager = (LocationManager) getSystemService (Context. 
LOCATION SERVICE); 
04 locationListener = new MyLocationListener (context, mapView, 
mapController) ; // 新 建 位 置 监听 器 对 象 
05 ”// 注 册 位 置 监 听 器 
06 locationManager.requestLocationUpdates (LocationManager .GPS PROVIDER, 
0, 0, locationListener); 


其 中 ，06 行 就 是 具体 注册 监听 器 的 代码 ， 该 方法 的 原型 是 : 


requestLocationUpdates (String provider, long minTime, float minDistance, 
LocationListener listener) 


参数 如 下 : 

provider: 需要 注册 的 provider 的 名 称 。 
minTime: 最 小 的 更 新 时 间 间 隔 。 
minDistance: 最 小 的 更 新 距离 。 
listener: 每 次 更 新 时 ， 该 监听 器 的 onLocationListener() 方 法 将 会 被 调用 


OODODODD 








o 
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(3) 初始 化 MapView 

初始 化 包括 了 设 定 是 否 使 用 默认 的 缩放 按钮 、 设 定 地 图 的 默认 缩放 等 级 ， 另 外 ， 由 于 
是 在 模拟 器 中 对 GPS 功能 进行 测试 ， 而 模拟 器 本 身 并 没有 GPS 模块 ， 因 此 也 不 会 有 自动 
的 LocationUpdates 事件 发 生 ， 所 以 还 需要 对 初始 位 置 进行 初始 化 ， 初 始 化 的 代码 如 下 : 

















01 mapView = (MapView) findViewById(R.id.map); // 绑 定 MapView 
02 mapView.setBuiltInZoomControls (true); // 使 用 默认 的 缩放 按钮 
03 mapView.displayZoomControls (true); // 显 示 缩 放 按钮 
04 mapController = mapView.getController (); // 得 到 地 图 控制 器 
05 final int defaultZoomLevel = 17; // 默 认 缩放 等 级 17 
06 mapController.setZoom (defaultZoomLevel); // 缩 放 等 级 调 至 默认 
07 final double dLong = 103.9242; // 默 认 地 点 的 经 纬度 
08 final double dLati = 30.75777; 
09 GeoPoint defaultPoint = new GeoPoint((int) (dLati*1E6), 

(int) (dLong*1E6)); // 默 认 地 理 位 置 对 象 
10 mapController .animateTo (defaultPoint) ; // 将 地 图 中 心 移 至 默认 地 理 位 置 


上 段 代码 中 ，02 行 设置 了 使 用 系统 内 建 的 缩放 按钮 ; 

06 行 设置 了 默认 的 缩放 等 级 ; 

10 行将 地 图 的 中 心 点 移动 到 默认 位 置 ， 为 了 验证 地 点 的 正确 性 ， 可 以 通过 网 页 版 的 
Google Map 或 者 Google Earth 客户 端 去 获取 你 熟悉 的 地 点 的 经 纬 数 据 ， 笔 者 在 此 选择 了 电 
子 科 技 大 学 作为 默认 地 点 。 

(4) 为 项 目 添加 权限 

由 于 使 用 GPS 定位 功能 需要 应 用 程序 有 获取 准确 地 理 位 置 的 权限 , 因此 需要 在 应 用 程 
序 的 AndroidManifestxml 文件 中 添加 相应 的 权限 声明 ， 和 否则 在 程序 运行 的 时 候 将 会 报错 ， 
MapsDemo 默认 地 申请 了 如 下 两 个 权限 : 


<uses-permission 
android:name="android.permission.ACCESS COARSE LOCATION" /> 
// 获 取 普 通 精度 定位 
<uses-permission android:name="android.permission.INTERNET" /> 


// 访 问 网 络 的 权限 
为 此 ， 需 要 再 增加 : 


<uses-permission android:name="android.permission.ACCESS FINE LOCATION" 


/>// 获 取 精 确定 位 


一 项 的 权限 声明 。 

(5) 使 用 DDMS 发 送 GPS 数据 模拟 位 置 获取 功能 

使 用 模拟 器 调试 GPS 功能 时 ， 借 助 于 DDMS 的 数据 发 送 功能 可 以 很 方便 地 向 模拟 器 
发 送 GPS 数据 ， 要 使 用 DDMS 的 发 送 数据 功能 ， 在 Eclipse 下 切换 到 DDMS 视图 〈 如 果 
切换 栏 中 没有 DDMS 视图 可 以 通过 单 击 右上 角 的 Open Perspective 一 Other 一 DDMS 打开 )。 
在 默认 的 DDMS 视图 下 ,左边 第 二 栏 就 是 Emulator Control 面板 (如 图 8.29), 在 该 面板 下 
可 以 实现 对 模拟 器 的 一 些 状态 的 设置 ， 例 如 调整 音量 、 电 量 、 模 拟 来 电 和 短信 等 等 ， 在 最 
下 方 则 是 用 于 模拟 地 理 位 置 的 Location Controls， 可 以 为 模拟 器 发 送 地 理 位 置 ， 包 括 发 送 
一 个 单独 的 位 置 (Manual)， 以 及 发 送 一 串 保 存在 文件 中 的 多 个 位 置 (GPX，KML) 等 几 
种 方式 。 
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@ Emulator control 忆 | 
Telephony Status 
oo toror ere] 
Telephony Actions 
Incoming number: 


加 Voice 
SMS 


al] [Hong up 
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图 8.29 Enmulator Control 面板 


在 图 8.29 中 ， 为 了 测试 前 面 得 到 的 代码 ， 在 Manual 选项 卡 下 选择 Decimal 选项 ， 填 
入 经 纬度 然后 单 击 Send 按钮 发 送 即 可 , 可 以 发 现 模 拟 器 上 的 地 图 由 初始 化 位 置 (电子 科技 
大 学 ， 如 图 8.30 所 示 ) 移动 到 了 新 的 位 置 〈 成 都 市 天 府 广 场 ， 如 图 8.31 所 示 )。 注 意 模拟 
器 的 通知 栏 ， 可 以 发 现 通知 栏 内 出 现 了 一 个 新 的 标志 〈 见 图 8.30、 图 8.31 中 位 于 3G 标志 
左 方 的 一 个 圆 形 标志 )， 这 就 是 GPS 正在 被 使 用 的 标志 。 
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图 8.30 初始 化 位 置 图 8.31 接收 到 新 GPS 数据 后 定位 到 新 地 点 


8.2.2 GPS 标记 显示 
在 前 面 一 小 节 中 介绍 了 如 何 通 过 获取 GPS 数据 来 定位 至 新 的 地 点 , 在 实际 应 用 中 经 常 
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会 遇 到 此 类 需求 ， 就 是 在 地 图 上 进行 标记 ， 包 括 使 用 地 标 标记 地 点 ， 或 者 使 用 弹出 气泡 来 
显示 相关 信息 ， 本 小 节 就 介绍 这 两 种 标记 的 方法 。 


1. 标记 效果 
需要 实现 的 标记 效果 如 图 8.32 和 图 8.33 所 示 。 
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图 8.32 在 地 图 上 显示 地 标 图 8.33 在 地 图 上 显示 气泡 


Google 4 Google 


2. 显示 地 标 


(1) 实现 PlaceMarker 类 

要 在 地 图 上 显示 一 个 地 标 〈 图 片 )， 需 要 使 用 Map API 中 的 OverlayItem 类 ，Overlay 
可 以 理解 为 覆盖 层 的 意思 ， 就 是 在 Mapview 上 散 盖 一 层 视图 。 为 此 需要 实现 一 个 地 标 类 并 
继承 OverlayItem 类 ， 代 码 如 下 : 


01 public class PlaceMarker extends OverlayItem { 


02 private static int placeID = 1; // 静 态 变量 ， 用 于 生成 递增 的 编号 

03 private int myID = 0; // 地 标 对 象 的 ID 

04 

05 public PlaceMarker (GeoPoint point, String title，String snippet, 
Drawable marker) { 

06 super (point, title, snippet); 

07 myID = placeID++; // 生 成 唯一 的 地 标 ID 

08 this.setMarker (marker); // 为 地 标 对 象 设置 标识 

09 } 

10 

ql public int getID(){ // 该 方法 用 于 获取 地 标 ID 

return myID; 

13 } 

14 } 
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如 代码 所 示 ， 地 标 PlaceMarker 类 的 构造 方法 的 参数 包括 了 指定 地 理 位 置 的 GeoPoint， 
以 及 地 标的 tile 和 snippet, 这 3 个 参数 也 是 其 基 类 OverlayItem 构造 方法 的 参数 ,OverlayItem 
类 提供 了 getPoint0 、getSnippet0 和 getTitle() 3 个 方法 来 分 别 返回 这 3 个 成 员 变 量 ， 对 于 
PlaceMarker 构造 方法 的 第 四 个 参数 Drawable 则 是 作为 标记 绘制 在 地 图 上 ， 通 过 基 类 的 
setMarker() 方 法 指定 Drawable 对 象 为 其 标记 。OverLayItem 类 所 包含 的 方法 如 表 8-1 所 示 : 


表 8-1 Overlayltem 类 的 方法 











类 名 描述 
Drawable getMarker(int stateBitset) 获取 指定 状态 〈stateBitset) 的 标志 图 
GeoPoint getPointO 返回 该 OverlayItem 的 地 理 位 置 
String getSnippetO 返回 该 OverlayItem 的 简介 
String getTitle0) 返回 该 OverlayItem 的 标题 
String routableAddress() 以 map-routable 格 式 返回 该 OverlayItem 的 位 置 


设置 该 OverlayItem 需 要 被 绘制 时 所 用 的 标记 
设置 多 个 状态 的 标记 


void setMarker(Drawable marker) 
Void setState(Drawable drawable, int stateBitset) 





(2) 实现 PlaceMarkerList 类 

由 于 通常 需要 在 MapView 上 显示 不 止 一 个 的 标记 , 因此 , 此 处 实现 了 一 个 用 于 管理 标 

记 列 表 的 类 一 一 PlaceMarkerList， 该 类 继承 自 ItemizedOverlay， 该 基 类 是 用 于 管理 一 系列 

的 OverlayItem 对 象 的 ， 它 可 以 设置 标记 的 显示 位 置 (boundCenter 方法 使 得 标记 的 中 心 点 

对 应 于 OverlayItem 的 GeoPoint; 而 boundCenterBottom 方法 使 得 标记 的 底 边 中 心 点 对 应 于 

OverlayItem 的 GeoPoint， 此 处 则 是 使 用 的 第 二 种 对 齐 方式 )。 另 外 ， 它 还 能 够 设置 一 个 用 

于 监听 被 Focus 的 对 象 变 化 的 监听 器 〈 当 某 个 OverlayItem 被 单 击 ， 则 称 其 被 Focus， 之 后 

如 果 另 外 一 个 OverLayItem 被 单 击 ， 则 Focus 转移 到 新 被 单 击 的 那个 对 象 )， 这 个 监听 器 即 
OnFocusChangeListener， 每 当 Focus 发 生 改变 时 ， 其 方法 : 


onFocusChanged (ItemizedOverlay overlay, OverlayItem newFocus) 


将 被 调用 ， 同 时 传 入 被 Focus 的 newFocus 对 象 ， 在 该 方法 内 可 以 进行 相关 的 操作 ， 如 
后 面 即将 实现 的 弹出 气泡 的 功能 。 下 面 来 分 析 一 下 PlaceMarkerList 的 代码 。 首 先 ， 该 类 采 
用 了 单 例 模式 来 获取 该 类 的 实例 ， 代 码 如 下 


01 private static PlaceMarkerList theInstance = null; 


// 静 态 变 量 ， 用 于 存放 该 类 唯一 的 实例 





02 Context mContext; 


03 
04 public PlaceMarkerList (Drawable defaultMarker, Context context) { 
// 构 造 方法 

05 super (boundCenterBottom(defaultMarker)); 

06 mContext = context; 

i: 

08 

09 public static PlaceMarkerList getInstance (Drawable defaultMarker, 
Context context) // 获 取 单 例 

ODE 

Wal if (theInstance == null) // 如 果 当 前 还 没有 生成 实例 

i 1 


.347 . 


实战 Android 应 用 开发 








13 


14 
15 
16 


theInstance = new PlaceMarkerList (defaultMarker, context); 
// 使 用 构造 方法 生成 实例 
return theInstance; // 返 回 实例 
} 


此 外 ，PlaceMarkerList 还 提供 了 addPlace(PlaceMarker placeMarker) 方 法 ， 用 于 问 
PlaceMarkerList 中 添加 新 的 元 素 : 


Public void addPlace (PlaceMarker placeMarker) { 
placeMarkerList.add (placeMarker); // 添 加 地 标 到 列表 
populate () 7 // 刷 新 显示 
} 


(3) 修改 MapViewDemo 
实现 了 PlaceMarker 和 PlaceMarkerList 之 后 ， 就 需要 在 MapViewDemo 中 添加 用 于 显 
示 PlaceMarker 的 代码 ， 首 先 ， 需 要 将 PlaceMarkerList 图 层 添加 到 MapView 的 Overlay 列 


表 中 ; 


01 
02 


03 
04 
05 


06 


// 添 加 新 的 图 层 用 于 显示 地 标 
List<Overlay> mapOverlays = mapView.getOverlays(); 

// 获 取 当 前 mapView 的 Overlay 列表 
final Drawable defaultMarker = this.getResources () .getDrawable (R. 


drawable.markera); // 绑 定 图 像 资源 
PlaceMarkerList PlaceMarkerList = PlaceMarkerList.getInstance 
(defaultMarker, this); // 获 取 地 标 列表 实例 


placeMarkerList.setOnFocusChangeListener (onFocusChangeListener); 


// 设 置 监听 器 ， 用 于 监听 焦点 变化 
mapOverlays .add (PlaceMarkerList) 7 
// 将 地 标 列 表 作 为 一 个 overlay 添加 到 mapView 中 


之 后 通过 手动 添加 标记 的 方式 ， 在 地 图 上 显示 两 个 标记 ， 在 实际 应 用 中 ， 可 以 根据 有 具 
体 需求 在 特定 的 事件 发 生 时 自动 地 添加 标记 : 


01 
02 
03 


04 
05 
06 
07 
08 
09 
10 


E 
12 


13 


14 


15 
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// 添 加 地 点 A 

final double dLongA = 103.9242; // 经 度 

final double dLatiA = 30.75777; // 纬 度 

GeoPoint geoPointA = new GeoPoint ((int) (dLatiA*1E6), (int)( 
aqLongR*1E6) ) 7 // 根 据 经 纬度 构造 GeoPoint 对 象 
final Drawable markera = this.getResources() .getDrawable (R.drawable . 
markera); // 绑 定 图 像 资 源 

PlaceMarker placeMarkerA = new PlaceMarker (geoPointR，" 学 校 "，" 电 子 科 
技 大 学 "，markera) ; // 构 造 地 标 对 象 
placeMarkerList.addPlace (PlaceMarkerR) ; // 将 地 标 添 加 到 地 标 列表 中 

// 添 加 地 点 B 

final double dLongB = 103.9258; 

final double dLatiB = 30.7547; 


GeoPoint geoPointB = new GeoPoint((int) (dLatiB*1E6), (int) 
(dLongB*1E6)); 

final Drawable markerb = this.getResources() .getDrawable (R.drawable. 
markerb); 

PlaceMarker placeMarkerB = new PlaceMarker (geoPointB, "公交 站 "， "阳光 
地 带 "，markerb) ; 

placeMarkerList.addPlace (placeMarkerB); 
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添加 了 如 上 代码 之 后 ， 再 运行 MapsDemo， 就 可 以 得 到 如 图 8.32 所 示 的 效果 了 。 
3. 弹出 式 气泡 


如 图 8.33 所 示 的 效果 ,通常 情况 下 仅仅 在 地 图 上 显示 出 地 标 并 不 能 满足 需求 ， 因 为 地 
标 不 能 够 为 用 户 提供 足够 的 信息 , 这 时 候 就 需要 使 用 到 弹出 式 气 泡 的 功能 , 实现 的 功能 是 : 
用 户 通过 单 击 地 图 上 的 标记 来 得 到 一 个 弹出 的 气泡 框 ， 在 气泡 框 中 为 用 户 显示 额外 的 地 点 
信息 。 

可 以 很 自然 地 想到 ， 气 泡 的 显示 也 是 通过 在 MapView 上 添加 覆盖 在 其 上 的 View 的 方 
式 来 实现 的 ， 为 此 ， 定 义 了 一 个 View 类 型 的 对 象 popView 用 于 实现 气泡 视图 的 显示 。 首 
先 需 要 实现 的 是 气泡 内 部 的 界面 布局 ， 与 Activity 的 布局 实现 一 样 ， 气 泡 内 部 的 布局 也 是 
通过 xml 文件 来 实现 的 ，popView 的 布局 xml 代码 如 下 : 


01 <?xml version="1.0" encoding="UTF-8"?> 
02 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/ 








android" 
03 android:layout width="wrap content" 
04 android:layout height="wrap Content" 
05 android:background="@drawable/bubble" 
06 android:orientation="vertical™" 
07 android:paddingBottom="10px"<!-- 文字 到 图 片 下 边缘 的 宽度 --> 


08 android:paddingLeft="5px"<!-- 文字 到 图 片 左 边缘 的 宽度 --> 
09 android:paddingRight="5px"<!-- 文字 到 图 片 右边 缘 的 宽度 --> 
10 android:paddingTop="5px"” ><!-- 文字 到 图 片上 边缘 的 宽度 --> 


1 

下 2 <RelativeLayout 

T3 android:layout width="match parent" 

14 android:layout height="wrap content" > 
3 

16 <TextView 

a android:id="@+id/map bubbleTitle" 
18 style="@style/map BubblePrimary" 
19 android:layout width="match parent" 
20 android:layout height="wrap content" 
21 android:singleLine="true" /> 

22 </RelativeLayout> 

| 

24 <TextView 

25 android:id="@+id/map bubbleSnippet" 

26 style="@style/map BubbleSecondary" 

Zh android:layout width="wrap_content" 

28 android:layout height="wrap_ content" 
29 android:clickable="true" 

30 android:singleLine="false" /> 

3 


32 </LinearLayout> 


其 中 ，07 一 10 行 指定 了 界面 内 容 与 边界 之 间 的 距离 ， 这 些 距 离 通常 与 具体 的 背景 图 片 
相关 ， 防 止 布局 的 内 容 与 背景 图 片 的 边界 发 生 冲突 ; 

16~21、24~30 行 指定 了 两 个 TextView， 需 要 注意 的 是 这 里 用 到 了 style 属性 和 
singleLine 属性 ，singleLine 属性 比较 简单 ， 即 指定 该 TextView 是 否 可 以 显示 多 行文 字 ， 而 
style 属性 则 是 定义 了 该 TextView 的 显示 风格 ，style 的 值 所 指定 的 是 在 values/style.xml 文 
件 中 定义 的 具体 style， 可 以 把 这 种 方式 类 比 为 编程 语言 中 的 “ 宏 ”，style.xml 的 内 容 稍 后 
将 会 给 出 。 
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(1) Draw 9-patch 工具 的 使 用 

上 述 代码 第 05 行 指定 了 该 气泡 的 背景 图 像 ， 图 片 的 类 型 是 9png， 该 类 型 图 片 可 以 根 
据 一 定 的 规则 进行 拉 伸 而 不 出 现 模糊 ， 可 以 借助 Android SDK 提供 的 工具 Draw 9-patch 
(<android-sdk>/tools/draw9patch bat) 来 制作 该 类 型 的 图 片 文件 ， 简 单 地 说 ， 这 种 方式 的 拉 
伸 就 不 是 简单 地 在 各 个 方向 进行 缩放 ， 而 是 通过 指定 最 多 9 个 〈 也 不 
一 定 是 9 个 ， 本 例 中 仅仅 指定 了 2 个 ) 供 拉 伸 的 像素 集合 ， 在 拉 伸 的 四 





时 候 通 过 复制 这 些 像 素 集合 来 实现 拉 伸 的 效果 ， 这 样 就 避免 了 简单 缩 
放 所 造成 的 效果 失真 。 

如 图 8.34 所 示 是 从 网 络 上 随机 找到 的 一 张 png 图 片 , 图 8.35 是 在 
Draw 9-patch 工具 中 对 其 进行 编辑 的 截图 ， 图 8.36 是 对 应 于 编辑 的 拉 


伸 效 果 。 
22 


图 8.35 ”使 用 Draw 9-patch 工具 编辑 图 片 


E = 丙 


图 8.36 对 应 于 图 8.35 所 编辑 的 拉 伸 效果 


图 8.34 原始 图 片 


如 图 8.35 所 示 , 右 半 部 分 出 现 的 红色 禁止 符号 表示 的 是 不 能 对 图 片 的 真实 部 分 进行 编 
辑 ，Draw 9-patch 工具 在 图 片 的 周围 额外 添加 了 一 个 像素 宽度 的 范围 用 于 指定 拉 伸 的 范围 
图 8.35 左 半 部 分 最 外 围 的 两 条 黑色 线段 所 对 应 的 两 个 截面 则 是 用 于 拉 伸 的 范围 ， 图 8.36 
所 示 的 则 是 图 像 的 3 种 不 同 的 拉 伸 状态 ， 请 读者 在 实际 的 编辑 过 程 中 来 体会 这 种 拉 伸 机 制 
的 实现 方式 。 

(2) 为 控件 定义 style 

前 面 提 到 的 style.xml 的 代码 如 下 : 


01 <?xml version="1.0" encoding="UTF-8"?> 
02 <resources> 
03 <style name="map BubblePrimary"> 
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04 <item name="android:textSize">12sp</item><!-- 一 级 字体 大 小 --> 
05 <item name="android:textColor">#000</item><!-- 一 级 字体 颜色 --> 
06 </style> 

07 <style name="map BubbleSecondary"> 

08 <item name="android:textSize">12sp</item><!-- 二 级 字体 大 小 --> 
09 <item name="android:textColor">#008</item><!-- 二 级 字体 颜色 --> 
10 </style> 

El </resources> 


如 代码 所 示 ， 可 以 通过 如 上 的 方式 ， 将 一 系列 的 属性 设置 定义 为 一 个 style， 供 其 他 的 
控件 使 用 。 此 处 定义 了 两 个 不 同 的 style， 一 个 是 气泡 标题 的 style， 另 一 个 是 气泡 的 简介 文 
字 的 style。 

(3) 初始 化 气泡 视图 

实现 了 气泡 的 布局 之 后 ， 通 过 方法 : 


popView = getLayoutInflater() .inflate (R.layout .bubble，null);// 填 充气 泡 
来 实现 对 气泡 视图 的 填充 ， 并 通过 如 下 代码 将 popView 添加 到 mapView 中 : 


01 mapView.addView (PopView，  // 添 加 气泡 到 mapView 


02 new MapView .LayoutParams (MapView.LayoutParams .WRAP CONTENT, 
03 MapView .LayoutParams .WRAP CONTENT, null, 
04 MapView .LayoutParams .BOTTOM | MapView.LayoutParams .RIGHT)); 


05 popView.setVisibility (View.GONE) ;// 气 泡 设 为 不 可 见 
06 bubbleTitle = (TextView) findViewById(R.id.map bubbleTitle); 
// 绑 定 TextView 
07 bubbleSnippet = (TextView) findViewById(R.id.map bubbleSnippet); 
其 中 ,mapView 的 addView 方法 包含 了 两 个 参数 ,第 第 一 个 参数 是 需要 添加 成 为 mapView 
的 子 视图 的 视图 对 象 ， 第 二 个 参数 则 是 用 于 设置 该 子 视 图 显示 方式 的 参数 。 如 代码 所 示 ， 
-个 MapView.LayoutParams 对 象 的 构造 方法 包含 了 4 个 参数 ， 分 别 是 ; 
口 int width: 用 于 定义 popView 的 宽度 ， 此 处 是 WRAP_ CONTENT。 
口 int height: 用 于 定义 popView 的 高 度 ， 也 是 WRAP_CONTENT。 
口 GeoPoint point: 用 于 指定 该 popView 需要 显示 的 点 ， 此 处 是 null， 将 在 需要 显示 
popView 的 时 候 为 该 变量 赋值 。 
口 int alignment: 指定 popView 的 对 齐 方式 ， 此 处 为 右 下 方 对 齐 ， 只 有 当 popView 的 
宽度 或 高 度 超 过 了 mapView 时 才 会 有 所 体现 。 
05 行 设置 了 popView 视 图 为 不 可 见 ,因为 此 时 也 不 能 够 决定 popView 应 该 显示 在 何 处 ， 
只 有 当 决 定 其 显示 位 置 的 GeoPoint 不 为 null 时 ， 才 能 够 成 功 地 显示 出 popView。 
(4) 实现 ItemizedOverlay.OnFocusChangeListener 和 BubbleThread 
在 前 面 修改 MapViewDemo 类 时 ， 添 加 了 placeMarkerList 到 MapView 中 ， 并 日 为 
placeMarkerList 设置 了 一 个 监听 器 : 


placeMarkerList.setOnFocusChangeListener (onFocusChangeListener); 
该 监听 器 的 作用 是 监听 被 Focus 的 item 的 变化 ， 代 码 实现 如 下 : 
01 private final ItemizedOverlay.OnFocusChangeListener onFocusChange— 


Listener = 
02 new ItemizedOverlay.OnFocusChangeListener() { 
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03 @Override 
04 Public void onFocusChanged (ItemizedOverlay overlay, OverlayItem 
newFocus) { 
05 if (newFocus != null) { 
06 // 将 气泡 在 被 新 单 击 的 地 点 处 显示 出 来 
07 MapView.LayoutParams geoLP = (MapView.LayoutParams) 
popView.getLayoutParams (); 
08 geoLP.point = newFocus .getPoint () 7 
09 PopView.setVisibility(View.VISIBLE) ;  // 将 气泡 设 为 可 见 
10 
全 1 bubbleThread = new BubbleThread (newFocus, mHandler); 
// 在 单独 的 线程 中 处 理气 泡 
法 bubbleThread.start (); 
13 } 
14 } 
1 





当 FocusChange 这 个 事件 发 生 时 ，onFocusChanged 方法 将 被 调用 ， 并 将 新 获得 焦点 的 
OverlayItem 对 象 传 入 ， 此 时 就 将 新 获得 焦点 的 对 象 的 GeoPoint 赋值 给 popView 的 
LayoutParams， 并 且 通 过 09 行 的 代码 设置 popView 为 可 见 ， 从 而 将 popView 显示 出 来 。 
popView 显示 出 来 之 后 ， 再 启动 一 个 BubbleThread 类 型 的 线程 来 填充 popView 内 的 控件 。 
使 用 线程 的 方式 可 以 方便 地 用 于 其 内 容 需 要 从 网 络 上 获取 的 情况 。 

例如 ， 气 泡 的 简介 是 从 一 个 网 络 地 址 获取 ， 为 了 防止 用 户 界面 被 阻塞， 从 而 使 用 线程 
的 方式 。BubbleThread 的 实现 如 下 : 

01 public class BubbleThread extends Thread { 





02 private OverlayItem newFocus; // 新 获取 焦点 的 对 象 ( 气 泡 或 者 地 标 ) 
03 private Handler mHandler; // 用 于 处 理 消息 队列 
04 
05 public BubbleThread (OverlayItem newFocus, Handler mHandler){ 

// 构 造 方法 
06 this.newFocus = newFocus; 
07 this.mHandler = mHandler; 
08 } 
09 
10 public void run() { 
FE Message msg = new Message(); 

// 实 例 化 Message 对 象 ， 用 于 发 送 给 Handler 处 理 

12 msg.what = MapViewDemo .MESSAGE TITLE; 

// 设 置 Message 的 what 字段 
13 msg.obj = newFocus.getTitle(); // 将 气泡 的 Title 存放 到 obj 中 
14 mHandler.sendMessage (msg); // 发 送 消 息 供 Handler 处 理 
9 msg = new Message(); // 再 次 发 送 消 息 ， 用 于 传递 气泡 的 描述 
16 msg.what = MapViewDemo .MESSAGE SNIPPET; 
by msg.obj = newFocus.getSnippet (); 
18 mHandler.sendMessage (msg); 
9 } 
20 
FL public void setNewFocus (OverlayItem newFocus) { 
FA this.newFocus = newFocus; 
之 3 } 
24 1} 


该 线程 的 功能 比较 简单 ， 就 是 通过 getTitle0 和 getSnippet() 方 法 来 获取 newFocus 对 象 
的 标题 和 简介 ， 并 通过 消息 的 形式 发 送 给 MapViewDemo 的 Handler 处 理 ，Handler 接收 到 
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由 BubbleThread 发 来 的 消息 之 后 ， 根 据 消 息 的 内 容 来 更 新 气泡 的 内 容 : 


01 // 用 于 处 理由 BubbleThread 发 来 的 消息 
02 mHandler = new Handler() { 


03 public void handleMessage (Message msg) { 
04 switch (msg.what) 
05 
06 case MESSAGE TITLE: // 新 处 理 的 消息 包含 了 气泡 的 Title 信息 
07 bubbleTitle.setText ( (String)msg.obj); 
// 显 示 到 对 应 的 TextView 上 
08 break; 
09 case MESSAGE SNIPPET:  // 新 处 理 的 消息 包含 了 气泡 的 描述 信息 
10 bubbleSnippet .setText ( (String)msg.obj); 
// 显示 到 对 应 的 TextView 上 
已 是 break; 
之 default: 
break; 
14 } 
Us super.handleMessage (msg) 
16 } 
7 


对 代码 进行 了 如 上 的 修改 之 后 ， 再 运行 MapViewDemo， 单 击 地 标 就 有 popView 弹出 
了 ， 如 图 8.33 所 示 。 


8.2.3 测 MapView 上 两 点 间距 离 


在 基于 GPS 的 定位 应 用 中 , 测量 距离 是 一 个 十 分 实用 的 功能 ， 例 如 ， 车 载 导航 仪 或 者 
手机 搭载 的 导航 应 用 ,在 移动 的 过 程 中 通常 会 有 一 些 特定 地 点 作为 “决策 点 ”， 即 当 车 辆 或 
人 在 按照 预定 的 路 线 行动 至 目的 地 的 过 程 中 ， 在 这 些 决 策 点 需要 做 出 明确 的 决策 如 左 转 、 
右 转 或 者 直行 等 ， 如 果 没 有 在 这 些 决策 点 做 出 正确 的 决策 ， 则 有 可 能 发 生 人 们 所 不 愿意 看 
到 的 后 果 ， 如 错过 高 速 公 路 出 口 、 走 过 目的 地 等 等 。 因 此 需要 借助 于 测量 某 两 个 位 置 的 距 
离 的 功能 来 实现 一 定 范围 内 的 提醒 。 

又 例如 , 在 一 个 LBS 社交 应 用 中 ， 可 以 通过 一 定 范围 内 的 靠近 提醒 功能 来 实时 建立 和 
朋友 之 间 的 联络 等 。 基于 这 样 一 类 的 需求 , 本 小 节 将 实现 在 MapView 上 测 两 点 间 的 距离 的 
功能 

1. 测 距 功能 说 明 





本 示例 将 要 完成 的 效果 是 : 通过 单 击 Google 地 图 来 选择 两 个 端点 , 将 这 两 个 端点 作为 
测 距 线段 的 两 端 ， 然 后 返回 该 线段 所 对 应 的 距离 。 在 功能 的 实现 时 ， 考 虑 到 在 选 点 操作 的 
过 程 中 可 能 会 有 移动 或 者 缩放 地 图 的 操作 ， 为 了 防止 发 生 误 操 作 ， 为 控制 选 点 操作 特意 增 
加 了 两 个 按钮 和 一 个 提示 文本 ， 如 图 8.37 所 示 ， 两 个 按钮 分 别 是 “开始 测 距 ” 和 “ 选 点 ” 
测 距 的 完整 流程 为 : 

(1) 单 击 “ 开 始 测 距 ”按钮 进入 到 测 距 状态 ， 可 以 看 到 最 上 方 出 现 操作 提示 文字 : “i 
先 点 击 [ 选 点 ]， 然 后 在 地 图 上 点 击 选择 第 一 个 端点 。” 如 图 8.38 所 示 。 
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请 先 点 击 [ 选 点 ] 








点 击 选择 第 一 个 端点 > 开始 测 距 
Electronlc Sclence and Stott 人 | 
Technology of China 


Technology of china 





图 8.37 初始 状态 


(2) 将 地 图 移动 和 缩放 到 合适 位 置 ， 
示 ， 此 处 欲 选择 第 一 个 点 为 电子 科技 大 学 ， 
最 上 方 的 操作 提示 文字 将 会 变 为 : 
点 作为 一 个 端点 ， 


图 8.38 单 击 “ 开 始 测 距 ” 按 钮 


确定 欲 选择 的 点 在 可 单 击 的 区 域 后 (如 图 8.38 所 

已 经 在 视图 中 央 了 )， 单 击 “ 选 点 ”按钮 ， 此 时 
请 选择 第 一 个 端点 ” 如 图 8.39 所 示 。 单 击 屏幕 上 的 - 
该 端点 被 标记 为 S 即 Start 的 含义 ， 如 图 8.40 所 示 。 


6 ; 才 





图 8.39 单 击 “ 选 点 ”按钮 


图 8.40 选择 第 一 个 点 
(3) 此 时 , 操作 提示 文字 变 为 “请 再 点 击 [ 选 点 ], 然后 在 地 图 上 点 击 选择 第 二 个 端点 。” 
如 图 8.40 所 示 ， 这 个 状态 下 可 以 自 


地 拖 忠 和 缩放 地 图 而 不 会 被 判定 为 选 点 操作 。 因 此 通 
过 缩放 和 拖 奥 移动 地 图 至 天 府 广场 区 域 ， 如 图 8.41 所 示 ， 然 后 























后 单 击 “ 选 点 ”按钮 ， 选 择 第 
二 个 点 ， 该 点 被 标记 为 D 即 destination 的 含义 ， 至 此 两 个 端点 已 经 确定 ， 最 上 方 的 文字 显 
.354 。 
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示 了 从 电子 科技 大 学 清水 河 校区 到 天 府 广场 的 直线 距离 为 17431.268， 以 米 为 单位 ， 如 图 
8.42 所 示 ， 测 距 完成 。 
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图 8.41 移动 地 图 图 8.42 选择 第 二 个 点 
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2. 实现 测 距 线 程 

示例 代码 中 实现 了 一 个 测 距 线程 类 MeasureDistance， 该 线程 的 作用 是 : 根据 选 点 的 结 
果 ， 计 算出 两 点 间 的 距离 并 将 该 结果 以 Message 的 形式 通过 Handler 发 送 给 主线 程 ， 主 线 
程 则 将 结果 显示 到 界面 上 。 线 程 的 代码 如 下 : 


01 public class MeasureDistance extends Thread { 


02 

03 private boolean waiting = true; // 测 距 流程 是 否 处 于 等 待 状态 

04 // 等 待 传 入 数据 (通过 setStartPoint 和 setDestPoint 方法 ) 

05 private volatile MeasureStep currentStep = MeasureStep.stepOne; 
// 存 放 当 前 所 进行 到 的 步骤 

06 private static GeoPoint startPoint = null; // 存 放 起 点 

07 private static GeoPoint destPoint = null; // 存 放 终 点 

08 private float[] results = {1.0f,1.0f,1.0f}; // 存 放 测 距 结果 

09 private Handler mHandler; // 用 于 处 理 消息 的 Handler 对 象 

10 

11 public MeasureDistance (Handler mHandler){ 

12 this.mHandler = mHandler; 

13 } 

14 

15 Q@Override 

16 public void run() { 

qe while (true){ // 循 环 直 到 退出 测 距 流程 

18 while (waiting) { // 循 环 等 待 测 距 进 行 

十 避 tryt{ 

20 Thread.sleep (200); 

福士 }catch (Exception e) { 
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} 
} 


measureProcedure (); // 执 行 所 需 的 测 距 步骤 
if(currentStep 一 MeasureStep.notMeasuring) break; 
} 
} 
// 根 据 流程 状态 做 不 同 的 处 理 


private void measureProcedure(){ 
waiting = true; 
switch (currentStep){ 


case stepOne:{ // 当 前 处 于 流程 第 一 步 
currentstep = MeasureStep.stepTwo; // 切 换 到 第 二 步 
break; 

} 

case stepTwo:{ // 当 前 处 于 流程 第 二 步 


// 使 用 distanceBetween () 方法 测 出 两 点 距离 ， 参 数 中 的 经 纬度 的 单位 是 度 

Location.distanceBetween (startPoint.getLatitudeE6()/1E6, 
startPoint.getLongitudeE6()/1E6, 
destPoint.getLatitudeE6()/1E6, 
destPoint.getLongitudeE6()/1E6, results); 

//System.out.println("results[0]: " + results[0] 

//+ "results[1]: " + results[1] + "results[2]: "+ 

results[2]); 
Message msg = new Message() ;// 新 建 Message 对 象 用 于 发 送 
msg.what = MapViewDemo .MESSAGE MEASURE; 


// 说 明 Message 的 类 型 
msg.obj = new Float (results[0]); // 将 测 距 结果 放 入 Message 
mHandler.sendMessage (msg); // 发 送 消息 
currentStep = MeasureStep.notMeasuring; 

// 将 状态 切换 到 非 测 距 状态 
break; 

| 

case notMeasuring:{ // 当 前 处 于 非 测 距 状态 ， 不 执行 任何 操作 
break; 

} 

} 


} 


public void setWaitingStatus (boolean status){ 
// 用 于 设置 当前 的 等 待 状态 
waiting = status; 


} 
public void stopMeasure(){ // 强 制 停止 测 距 线 程 


currentStep = MeasureStep.notMeasuring; 
waiting = false; 


} 


public MeasureStep getMeasureStatus(){ // 获 取 当 前 所 处 的 步 数 
return CurrentStep7 


} 
public void setStartPoint (GeoPoint point){ // 设 置 起 点 
startPoint = point; 


} 


public void setDestPoint (GeoPoint point){ // 设 置 终 点 
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3. destPoint = point; 
78 } 

79 

80 // 测 距 流程 状态 

81 Public enum MeasureStep{ 
82 stepOne, 

83 stepTwo, 

84 notMeasuring 

85 } 

960 


上 述 代 码 的 81 一 85 行 定义 了 一 个 用 于 描述 测 距 流 程 状态 的 枚 举 类 型 MeasureStep， 该 
枚 举 类 型 包含 了 3 个 元 素 : stepOne、stepTwo 和 notMeasuring, 分 别 代 表 测 距 的 第 一 步 ( 选 
择 Start 点 )、 第 二 步 (选择 Destination 点 ) 以 及 非 测 距 状 态 。 线 程 自 身 通过 这 个 枚 举 类 型 
来 确定 当前 流程 的 状态 ， 并 且 向 外 部 提供 getMeasureStatus0 接 口 〈68 一 70 行 )， 供 其 他 类 
查询 当前 流程 的 状态 。 

代码 03 行 定义 的 布尔 变量 waiting 用 于 指明 测 距 流 程 是 否 处 于 等 待 状态 ， 一 个 测 距 流 
程 通常 会 出 现 两 次 等 待 ， 第 一 次 即 线程 开始 后 等 待 选取 第 一 个 点 ， 此 时 线程 将 会 循环 在 
18 一 24 行 代码 中 ， 等 待 Activity(MapViewDemo) 使 用 setWaitingStatus(boolean status) 接 口 将 
waiting 的 值 置 为 false, 这 个 置 为 false 的 动作 发 生 在 Activity(MapViewDemo) 取 得 了 用 户 所 
选择 的 点 之 后 (setStartPoint 和 setDestPoint)， 即 用 户 每 选择 一 次 点 ， 都 会 将 测 距 流程 向 前 
推进 一 步 ， 当 测 距 流 程 状态 为 notMeasuring 时 ， 线 程 终 止 ， 测 距 流程 结束 。 

在 测 距 流程 的 第 二 步 ， 已 经 获取 了 用 户 选择 的 第 二 个 点 之 后 ， 将 使 用 由 
android.location.Location 类 提供 的 静态 方法 distanceBetween() 来 计算 出 两 点 间 的 距离 , 然后 
将 计算 结果 通过 mHandler 发 送 消息 给 主线 程 ，distanceBetween() 方 法 的 原型 为 : 

distanceBetween (double startLatitude, double startLongitude, double 

endLatitude, double endLongitude, float[] results) 

参数 列表 : 

口 startLatitude: 起 点 的 纬度 值 ， 即 一 个 端点 的 纬度 值 。 
startLongitude: 起 点 的 经 度 值 ， 即 一 个 端点 的 经 度 值 。 
endLatitude: 终点 的 纬度 值 ， 即 另 一 个 端点 的 纬度 值 。 
endLongitude: 终点 的 经 度 值 ， 即 另 一 个 端点 的 经 度 值 。 
results: 浮 点 型 数组 ,用 于 存放 计算 结果 , 最 多 返回 3 个 数值 ,分别 存放 于 results[0]、 
results[1]、results[2]， 其 中 results[0] 中 存放 的 是 以 米 为 单位 的 距离 数值 。 

代码 40 一 43 行 就 是 将 用 户 选择 的 两 点 的 经 纬 数值 传 入 distanceBetween() 方 法 , 然后 计 
算出 结果 保存 在 results 数组 中 。 然 后 将 results[0] 的 值 用 Message 对 象 进行 封装 ， 并 发 送 给 
主线 程 处 理 ， 然 后 将 测 距 流 程 状态 设置 为 notMeasuring， 表 示 测 距 流 程 终止 ， 如 代码 46 一 
50 行 。 

另外 , 还 提供 了 stopMeasure 接口 , 用 于 在 特殊 情况 下 终止 测 距 线程 (代码 63 一 66 行 )。 

3. 选 点 


前 面 实 现 了 用 于 表明 线程 状态 及 测 距 的 线程 类 ， 剩 下 的 工作 就 是 实现 在 地 图 上 选择 两 
个 点 并 发 送 给 MeasureDistance 线程 , 在 选 点 过 程 中 所 需要 解决 的 问题 , 即 解决 选 点 操作 和 
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拖 忠 地 图 操作 之 间 的 冲突 ， 下 面 就 来 具体 地 说 明 选 点 的 实现 。 

(1) 修改 缩放 按钮 

首先 需要 解决 的 问题 是 屏幕 触摸 事件 的 响应 问题 ， 在 前 面 的 代码 中 直接 使 用 了 内 建 的 
缩放 按钮 来 进行 对 地 图 的 缩放 操作 ,这 个 内 建 的 缩放 按钮 提供 了 一 个 自动 淡 入 淡出 的 功能 ， 
即 在 默认 的 情况 下 不 显示 缩放 按钮 ， 而 在 用 户 触 摸 屏幕 的 时 候 再 淡 入 显示 缩放 按钮 ， 并 且 
在 用 户 闲 置 屏幕 一 段 时 间 之 后 自动 隐 去 缩放 按钮 。 因 此 ， 这 个 机 制 将 会 捕获 用 户 触摸 屏幕 
的 事件 ， 从 而 对 该 示例 所 需要 实现 的 触摸 选 点 操作 造成 了 影响 。 为 了 解决 这 个 问题 ， 从 原 
来 的 代码 中 注释 掉 使 用 内 建 的 缩放 按钮 代码 如 下 : 

// 使 用 内 建 的 缩放 按钮 

//mapView.setBuiltInZoomControls (true); 

//mapView.displayZoomControls (true); 

然后 增加 新 的 缩放 按钮 ， 新 的 缩放 按钮 将 一 直 处 于 显示 状态 ， 这 样 它 就 不 用 再 去 捕获 
用 户 触摸 屏幕 的 事件 了 。 实 现 新 的 缩放 按钮 并 不 复杂 ， 因 为 Android 提供 了 ZoomControls 
控件 可 供 使 用 ， 为 此 在 mapview.xml 中 添加 : 

<ZoomControls 

android:id="@+id/zoomControls" 


android:layout width="wrap content" 
android:layout height="wrap content" 

















android:layout alignParentBottom="true" <!-- 对 齐 父 视图 的 底部 --> 
android:layout centerInParent="true" > <!-- 位 于 父 视 图 的 中 间 --> 
</ZoomControls> 


然后 在 MapViewDemo 中 添加 ZoomControls 对 单 击 事件 的 响应 : 
// 设 置 缩放 


ZoomControls zoomControls = (ZoomControls) this.findViewById(R.id. 
ZoomControls); 
zoomControls.setOnZoomInClickListener (new View.OnClickListener() { 
// 放 大 事件 监听 器 
public void onClick(View v) { 
mapController.zoomIn(); // 如 果 放 大 按钮 被 单 击 ， 则 放大 当前 显示 
} 
Ps 
zoomControls.setOnZoomOutClickListener (new View.OnClickListener() { 
// 缩 小 事件 监听 器 
public void onClick(View v) { 
mapController.zoomOut (); // 如 果 缩 小 按钮 被 单 击 ， 则 缩小 当前 显示 
} 
证 


(2) 增加 功能 按钮 

前 面 已 经 提 到 了 选 点 的 实现 还 需要 借助 两 个 按钮 ， 为 此 ， 在 mapview.xml 中 为 界面 添 
加 两 个 额外 的 按钮 ， 并 为 这 两 个 按钮 添加 单 击 事件 监听 器 ， 代 码 如 下 : 

01 // 此 按钮 用 于 开始 一 次 测 距 流 程 


02 Button startMeasure = (Button) findViewById(R.id.startMeasure); 
03 startMeasure.setOnClickListener (new View.OnClickListener() { 

04 

05 Q@Override 

06 public void onClick(View v) { 

07 if(measureDistanceThread != null)f{ 
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// 如 果 当 前 有 未 进行 完 的 测 距 线程 


measureDistanceThread.stopMeasure () 


// 终 止 当前 未 进行 完 的 测 距 线程 


a = new MeasureDistance (mHandler); 

// 新 建 测 距 线程 
measureDistanceThread. start() ; // 开 始 测 距 线程 
hintMessage.setText (""); // 清 空 提示 文字 
hintMessage.setText ("请 先 点 击 [ 选 点 ], 然后 在 地 图 上 \n 点 击 选择 第 一 
个 端点 。"); // 更 新 提示 


} 
2 


// 此 按钮 用 于 设置 当前 是 否 处 于 取 点 状态 
Button activateSelect = (Button) findViewById(R.id.activateSelect); 
activateSelect.setOnClickListener (new View.OnClickListener() { 


@Override 
public void onClick(View v) { 
if(measureDistanceThread == nul1){ // 当 前 并 没有 测 距 线程 在 执行 
hintMessage.setText (" 请 先 单 击 开始 测 距 按钮 ") ; ”// 更 新 提示 
return; 
} 
selectPointActivated = true; 
// 该 布尔 变量 表示 当前 是 否 可 以 通过 单 击 取 点 


switch (measureDistanceThread.getMeasureStatus ()){ 


// 根 据 所 处 的 步骤 更 新 提示 
case stepOne: // 处 于 第 一 步 
hintMessage .setText (" 请 选择 第 一 个 端点 ") ; // 更 新 提示 
break; 
case stepTwo: // 处 于 第 二 步 
hintMessage .setText ("请 选择 第 二 个 端点 "); // 更 新 提示 
break; 


} 
} 
和 


如 代码 所 示 ， 这 两 个 按钮 的 功能 分 别 是 : 
口 启动 新 的 测 距 线程 ， 并 更 新 提示 信息 (代码 10 一 13 行 )， 如 果 当 前 有 未 完成 的 线 


程 ， 则 停止 当前 线程 (代码 07 一 09 行 ) 并 开始 新 的 线程 。 


口 置 selectPointActivated 标志 为 tue， 即 激活 选 点 模式 〈 代 码 27 行 )， 该 布尔 变量 是 


一 个 属于 MapViewDemo 的 成 员 变量 ， 该 变量 专用 于 区 分 当前 的 状态 以 确定 将 触 
摸 事 件 处 理 为 选 点 操作 还 是 拖 忠 地 图 操作 。 然 后 根据 测 距 线程 measureDistance 
Thread 的 状态 来 更 新 提示 信息 (代码 28 一 35 行 )。 


(3) 实现 触摸 事件 监听 器 
前 面 已 经 能 够 通过 按钮 来 控制 线程 状态 ， 下 面 需要 实现 的 功能 是 根据 当前 的 选 点 状态 





来 将 触摸 选 点 结果 反映 在 地 图 上 ， 基 本 逻辑 是 : 如 果 当 前 selectPointActivated 标志 为 假 ， 
则 表明 当前 处 于 非 选 点 状态 ， 该 监听 器 将 不 做 任何 操作 直接 将 触摸 事件 传 给 下 一 级 处 理 ; 
如 果 selectPointActivated 标志 为 真 , 则 根据 当前 测 距 流程 的 状态 来 进行 相应 的 下 一 步 操作 。 


当 流 程 状态 为 stepOne 时 ， 向 地 图 中 添加 S 点 并 且 通 过 setStartPoint( 方 法 将 该 点 传 给 


measureDistanceThread。 当 流程 状态 为 stepTwo 时 , 向 地 图 中 添加 D 点 并 且 通 过 setDestPoint 
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方法 将 该 点 传 给 measureDistanceThread， 同 时 使 用 setWaitingStatus0 方 法 将 线程 的 等 待 状 
态 置 为 假 ， 从 而 推进 线程 执行 ， 再 置 selectPointActivated 标志 为 假 ， 等 待 下 一 次 选 点 。 具 
体 代码 如 下 : 
01 // 为 mapView 注册 触摸 事件 监听 器 ， 该 监听 器 的 作用 是 当 处 于 “ 选 点 ”状态 时 ， 
02 // 响 应 触摸 操作 ， 该 响应 将 在 地 图 对 应 位 置 标记 一 个 标志 。 该 事件 的 处 理 方式 
03 ”// 与 测 距 线 程 的 状态 、 是 否 处 于 选 点 模式 有 关 
04 mapView.setOnTouchListener (new View.OnTouchListener() { 
05 
06 @Override 
07 public boolean onTouch(View v, MotionEvent event) { 
08 int actionType = event .getAction(); // 获 取 动 作 类 型 
09 if(!selectPointActivated) return false; 
// 如 果 当 前 不 处 于 可 选 点 的 状态 ， 不 作 处 理 ， 直 接 返 回 
10 // 当 前 测 距 流 程 不 为 null 并 且 动作 类 型 为 按 下 
1 if(measureDistanceThread != null && actionType == 
MotionEvent .ACTION DOWN){ 
12 // 如 果 测 距 流 程 不 处 于 非 测 距 状 态 
4 es if (measureDistanceThread.getMeasureStatus() != Measure-— 
Step .notMeasuring) { 
14 int coordinateX = (int) event.getX(); 
// 获 取 单 击 的 像素 X 坐标 
LS int coordinateY = (int) event.getY(); 
// 获 取 单 击 的 像素 了 坐标 
16 GeoPoint Point = mapView.getProjection() 
// 将 像素 坐标 转换 为 经 纬度 
hy .fromPixels (coordinateX, coordinateY); 
18 Switch (measureDistanceThread.getMeasureStatus () ) { 
// 根 据 当 前 进行 到 的 步骤 作出 处 理 
19 case stepOne: // 当 前 处 于 测 距 第 一 步 
20 final Drawable markers = MapViewDemo .this// 绑 定 图 像 资源 
之 .getResources() .getDrawable (R.drawable.markers); 
22 PlaceMarker PlaceMarkerS = new PlaceMarker (point, 
"起 点 "，"11X11"，markers); 
Pe PlaceMarkerList.addPlace (PLaceMarkerS) : 
// 实 例 化 地 标 并 且 添加 到 地 标 列表 
24 measureDistanceThread.setStartPoint (Point) 
// 将 这 一 步 单 击 的 点 作为 起 点 
25 hintMessage .setText ("请 再 单 击 [ 选 点 ] ， 然 后 在 地 图 上 \n 单 
击 选 择 第 二 个 端点 。") ; 
26 break; 
27 case stepTwo: // 当 前 处 于 测 距 第 二 步 
28 final Drawable markerd = MapViewDemo .this// 绑 定 图 像 资源 
29 -getResources () .getDrawable (R.drawable .markerd); 
30 PlaceMarker PlaceMarkerD = new PlaceMarker (point, 
本 
31 placeMarkerList.addPlace (placeMarkerD); 
// 实 例 化 地 标 并 且 添 加 到 地 标 列表 
加 芝 measureDistanceThread.setDestPoint (point); 
// 将 这 一 步 单 击 的 点 作为 终点 
39 break; 
34 ji 
35 measureDistanceThread.setWaitingsStatus (false); 
// 设 置 线程 等 待 标志 为 false， 线 程 向 前 
36 selectPointActivated = false; // 取 消 选 点 状态 
Si mapView.postInvalidate () // 更 新 显示 
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38 return true; 

39 }else{ 

40 measureDistanceThread = null; 
41 . 

42 } 

43 return false; 

44 } 

45. })s 


如 代码 中 加 粗 的 部 分 ，09 一 13 行 、18、19 和 27 行 是 用 于 判断 选 点 状态 的 逻辑 ，24、 
32、35 和 36 行 代码 则 是 分 别 用 于 传递 选 点 结果 以 及 改变 选 点 状态 。 
至 此 ， 已 经 能 够 按 一 定 的 流程 来 获取 用 户 需要 测 距 的 两 个 端点 了 ， 剩 下 的 工作 就 是 输 





4. 添加 Handler 处 理 
在 上 文 节 中 选 定 了 两 个 端点 后 ， 主 线程 将 会 收 到 由 前 面 测 距 线程 发 回 的 结果 消息 ， 因 
此 需要 添加 对 该 消息 的 处 理 从 而 在 界面 中 显示 出 结果 : 


01 // 用 于 处 理由 Thread 发 来 的 消息 
02 mHandler = new Handler() { 





03 public void handleMessage (Message msg) { 
04 switch (msg.what) // 根 据 消息 类 型 作 不 同 处 理 
05 { 
06 case MESSAGE TITLE: // 用 于 更 新 气泡 Title 的 消息 
07 bubbleTitle.setText( (String)msg.obj); 
// 取 出 字符 串 并 且 更 新 气泡 Title 
08 break; 
09 case MESSAGE SNIPPET: // 用 于 更 新 气泡 描述 的 消息 
10 bubbleSnippet .setText ( (String)msg .obj); 
// 取 出 字符 串 并 且 更 新 气泡 描述 文字 
事业 break; 
2 case MESSAGE MEASURE: // 用 于 显示 测 距 结果 的 消息 
i hintMessage .setText ("两 点 间距 离 为 : "+ ( (Float)msg.obj). 
floatValue () + " 米 "); 
14 break; 
15 default: 
16 break; 
7 } 
18 super.handleMessage (msg); 
9 } 
20° hs 


其 中 ，12 一 14 行 即 为 添加 的 用 于 处 理 MeasureDistance 线程 所 发 回 的 结果 消息 的 代码 ， 
该 行 代码 将 取出 Message 中 的 结果 数据 并 将 其 显示 到 最 上 方 的 提示 文本 中 。 


8.3 在 MapView 上 绘制 轨迹 


当 你 外 出 游玩 时 ， 你 是 否 想 记 录 下 你 所 经 过 的 路 线 呢 ? 记录 下 自己 经 过 的 路 线 ， 不 仅 
可 以 供 自己 在 日 后 回味 ， 也 可 以 向 亲朋 好 友 分 享 自己 的 旅程 。 借 助 于 GPS 定位 以 及 
MapView 就 能 够 方便 地 实现 这 样 的 功能 ， 本 节 将 讨论 该 功能 的 实现 方法 。 
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8.3.1 轨迹 绘制 说 明 


类 似 于 8.2.2 小 节 标 记 效果 的 实现 原理 ， 在 MapView 上 绘制 轨迹 也 可 以 利用 在 其 上 添 
加 Overlay 的 方法 来 实现 ,为 了 实现 轨迹 的 折线 效果 ， 可 以 把 轨迹 分 解 成 一 段 一 段 的 线段 ， 


每 一 个 线段 根据 两 个 GPS 返回 的 地 理 位 置 来 确定 即 可 。 


为 了 方便 读者 的 测试 ， 本 小 节 将 要 实现 的 示例 中 ， 采 月 





日 两 种 方式 来 获取 一 系列 的 地 理 


位 置 经 纬 数据 ， 第 一 种 方式 是 通过 Google Earth 生成 kml 文件 的 方法 来 模拟 一 连 串 的 地 理 


位 置 数 据 ;第 二 种 方式 是 借助 于 Google Map 提供 的 Web 
Service 接口 来 获取 代表 两 个 地 点 间 路 径 的 xml 数据 。 
kml 是 一 种 基于 xml 标准 的 文件 ， 每 一 个 kml 文件 中 包 
含 了 若干 个 代表 地 理 位 置 的 节点 ,通过 实现 对 kml 文件 
的 解析 功能 即 可 得 出 一 连 串 的 地 理 位 置 , 利用 这 些 地 理 
位 置 ， 就 能 够 在 MapView 上 绘制 出 轨迹 。 随 后 会 介绍 
如 何 利用 Google Earth 生成 代表 一 段 路 径 的 kml， 以 及 
如 何 借助 Google Web Service 获取 xml。 
划 助 于 kml 所 提供 的 经 纬 数据 ,可 以 使 用 Projection 

的 toPixels() 方 法 将 经 纬 数据 转换 为 屏幕 上 的 像素 坐标 ， 
然后 再 在 Overlay 的 draw 方法 中 使 用 Canvas 在 屏幕 上 
绘制 出 这 些 线段 即 可 。 本 示例 中 利用 Google Earth 生成 
的 是 从 电子 科技 大 学 清水 河 校区 到 成 都 市 天 府 广 场 的 

- 段 路 径 , 示例 的 运行 效果 如 图 8.43 所 示 , 图 中 蓝 色 的 
线条 就 是 新 绘制 上 去 的 这 条 路 径 。 


8.3.2 使 用 Google Earth 生成 kml 文件 


开始 测 距 


Tuanjiezhen 一 Barzhul 


Longqiaozh| 


选 点 _ 





图 8.43 ”轨迹 绘制 结果 


前 文 提 到 的 第 一 种 方法 需要 使 用 到 由 Google Earth 所 生成 的 代表 路 径 的 kml 文件 ， 因 
此 这 里 简要 介绍 一 下 如 何 使 用 Google Earth 来 生成 这 种 文件 ， 首 先 需 要 到 Google Earth 的 
网 站 上 去 下 载 软件 。 直接 用 Google 搜索 Google Earth 关键 字 , 通常 第 一 个 链接 就 是 Google 
Earth 的 下 载 页 面 ， 页 面 地 址 为 http://www.google.com/earth/index.html， 如 图 8.44 所 示 ， 在 
该 页 面 上 可 以 下 载 到 最 新 发 布 的 Google Earth 应 用 程序 ， 当 前 发 布 的 最 新 版 本 是 Google 


Earth 6。 


Google earth 


Home® Explore Download Connect ”Help 






“362” 


Get the worid's geographic 
information at your fingertips. 


Download Google Earth 6 


图 8.44 ”Google Earth 主页 面 
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1. Google Earth 的 功能 














下 载 并 安装 Google Earth， 运 行 之 后 界面 中 央 将 会 出 现 一 个 3D 的 地 球 模型 。Google 
Earth 是 一 个 功能 十 分 强大 的 软件 , 它 能 够 给 用 户 带 来 极 强 的 视觉 和 操作 震撼 , 它 的 一 些 功 
能 包括 : 

口 使 用 它 来 观测 地 球 上 任何 一 个 地 点 的 景观 ， 它 的 精确 度 能 够 让 用 户 清晰 地 辩 明 地 

面 的 道路 、 车 辆 、 建 筑 以 及 河流 山脉 等 等 ， 只 要 你 足够 细心 ， 你 也 许 会 成 为 地 球 

上 某 一 处 景观 的 第 一 个 发 现 者 。 

支持 45” 角 的 景观 浏览 。 

越 来 越 多 的 3D 建筑 模型 。 

支持 众多 地 区 的 街景 模式 ， 使 你 有 身 临 其 境 的 感觉 。 

众多 地 点 的 360” 全 景 照片 。 

支持 海底 景观 ， 用 户 可 以 用 它 来 探索 丰富 的 海底 世界 。 

飞行 模拟 器 ， 当 飞行 模拟 器 开启 时 ， 用 户 将 被 假想 成 为 一 架 飞 行 器 的 驾驶 员 ， 通 

过 类 似 于 游戏 的 操作 来 控制 飞行 器 ， 得 到 近似 于 “ 鸟 喇 ”的 体验 ， 当 然 前 提 是 你 

没有 让 你 的 飞行 器 坠毁 或 者 飞 离 地 球 。 

口 利用 Google Earth， 你 可 以 制作 一 段 录 像 然 后 发 布 到 互联 网 上 ， 让 你 化 身 为 导游 带 
领 观看 者 按 你 设计 的 路 线 游览 。 

口 绝对 不 逊色 于 任何 地 图 软件 的 地 图 功能 ， 你 可 以 使 用 Google Earth 来 规划 你 的 路 
线 ， 查 询 地 点 等 等 ， 借 助 于 Google 所 拥有 的 庞大 的 数据 库 ， 让 你 能 够 对 每 个 地 点 





DOOODOCO 


都 能 获取 足够 的 信息 。 
口 Google Earth 甚至 已 经 “ 冲 出 ”了 地 球 ， 现 在 还 能 够 在 Google Earth 中 观测 月 球 、 
火星 以 及 星空 。 


Google Earth 还 提供 了 很 多 很 多 值得 去 探索 的 功能 。 例 如 ， 最 近 几 年 的 圣诞 节 你 甚至 
可 以 通过 Google Earth 来 观察 圣诞 老人 和 他 的 鹿 拉 雪 权 的 位 置 ， 通 过 Google Earth 还 能 够 
观测 月 食 。 

读者 可 以 自己 花 一 点 时 间 来 熟悉 一 下 Google Earth 的 使 用 ， 它 的 操作 非常 的 直观 和 易 
用 ， 如 图 8.45 所 示 ， 在 左 侧 边 栏 中 包括 了 “搜索 ””“ 位 置 ” 及 “图 层 ” 三 个 视图 ， 在“ 搜 
索 ” 视 图 中 可 以 方便 地 搜索 地 点 ， 在 “位 置 ” 视 图 中 将 会 列 出 你 所 保存 的 位 置 、 轨 迹 ， 在 
“图 层 ” 视 图 中 则 是 控制 在 Google Earth 上 所 显示 的 图 层 ， 你 可 以 通过 色 选 你 感 兴趣 的 图 层 
来 使 其 显示 在 Google Earth 上 。 


2. 生成 kml 文 件 


熟悉 了 Google Earth 的 使 用 后 ， 就 准备 来 生成 需要 的 kml 文件 了 。 首 先 需 要 确定 路 径 
的 起 点 ， 单 击 上 方 工具 栏 中 的 “添加 地 标 ” 室 按钮 ， 然 后 选择 一 个 点 作为 路 径 的 起 点 ， 
如 本 例 中 选择 的 是 电子 科技 大 学 清水 河 校区 作为 起 点 ， 如 图 8.46 所 示 。 

(1) 在 Google Earth 上 标记 出 起 点 之 后 ， 右 键 单 击 该 图 标 ， 然 后 选择 “从 此 处 出 发 的 
路 线 ” 此 时 搜索 视图 会 自动 切换 到 “路 线 ” 选项 卡 ， 并 且 自 动 将 刚才 标记 的 起 点 填 入 正确 
的 位 置 。 用 同样 的 方式 ， 再 次 添加 地 标 作 为 目的 地 ， 然 后 右键 单 击 地 标 图 标 选择 “以 此 处 
为 目的 地 的 路 线 ” 选择 完成 后 ，Google Earth 上 会 自动 绘制 出 一 条 从 起 点 到 终点 的 路 径 ， 
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如 图 8.47 所 示 。 
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图 8.46 ”选择 电子 科技 大 学 作为 起 点 


(2) 在 得 到 这 条 生成 好 的 路 径 后 ， 便 可 以 使 用 导出 功能 来 得 到 kml 文件 了 。 在 左 侧 边 
栏 的 “搜索 ”视图 的 “路 线 ” 选 项 卡 中 有 一 个 树 形 视图 ， 这 个 树 形 视图 包含 了 许多 节点 ， 
从 第 一 个 到 倒数 第 二 个 节点 用 于 代表 这 条 路 径 中 的 所 有 地 点 《每 个 节点 都 包括 了 其 代表 地 
点 的 诸多 信息 ), 最 后 一 个 节点 代表 这 条 完整 路 径 , 因此 只 需要 最 后 一 个 节点 的 数据 即 可 完 
成 路 径 绘制 的 工作 。 

(3) 为 此 ， 可 以 在 该 节点 上 右键 单 击 并 在 菜单 中 选择 “将 位 置 另存 为 ”命令 ， 或 者 直 
接 右键 单 击 地 图 上 蓝 色 的 轨迹 线 并 在 弹出 菜单 中 选择 “将 位 置 另存 为 ”命令 ， 然 后 保存 文 






























































.364 


第 8 章 传感器 、GPS 应 用 开发 











件 时 选择 文件 类 型 为 kml 即 可 。 将 会 得 到 一 个 名 为 “路 线 kml” 的 文件 ， 使 用 记 寻 





该 文件 可 以 发 现 文件 的 结构 如 下 : 





图 8.47 在 Google Earth 上 生成 的 轨迹 


01 <?xml version="1.0" encoding="UTF-8"?> 
02 <kml xmlns="http://www.opengis.net/kml/2.2" 














有 本 打开 


> 


03 xmlns:gx="http://www.google.com/kml/ext/2.2" 
04 xmlns:kml="http://www.opengis.net/kml/2.2" 
05 Xmlns:atom="http://www.w3.org/2005/RAtom"> 
06 <Placemark> 
07 <name> 路 线 </name> 
08 <visibility>0</visibility> 
09 <description><! [CDATA [路程 : 21.6&#160; 公 里 (大 约 34 分 钟 ) <br/ 
0 地 图 数据 @2011 Mapabc]]></description> 
小 <styleUrl>#roadStyle</styleUrl> 
2 <MultiGeometry> 
<LineString> 
4 <coordinates> 
5 103.92328, 30.75685,0 -……- 
16 </coordinates> 
汪 入 </LineString> 
18 </MultiGeometry> 
9 </Placemark> 
20 </kml> 
其 中 第 15 行 省 略 了 大 部 分 的 经 纬 数据 ， 正 是 利用 这 一 行内 容 所 记录 的 一 系列 数据 来 
绘制 轨迹 的 。 为 了 在 代码 中 能 够 使 用 该 文件 ， 将 其 文件 名 修改 为 testkml 并 存放 在 项 目的 











/assets 目录 下 。 
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3. 实现 解析 kml 文 件 的 线程 类 


获取 了 正确 的 路 线 文件 后 ， 就 需要 在 代码 中 导入 并 且 解 析 该 文件 ， 然 后 根据 解析 出 的 
数据 绘制 轨迹 。 为 此 实现 了 一 个 用 于 解析 获取 到 的 kml 文件 的 线程 类 TrackThread， 该 线程 


的 构造 方法 如 下 : 


01 
02 
03 
04 
05 
06 
07 





private InputStream mTrackPointInputStream = null;// 文 件 输入 流 
private Handler mHandler;// 用 于 向 主线 程 发 送 消息 


public TrackThread (InputStream inputStream, Handler mHandler) { 


mTrackPointInputStream = inputSstream; 
this.mHandler = mHandler; 


可 以 看 到 ， 构 造 方法 传 入 了 两 个 参数 ， 它 们 的 作用 分 别 是 : 

口 inputStream: 待 解析 文件 的 输入 流 。 

口 mHandler: 用 于 向 主线 程 发 送 消息 的 Handler 类 。 

可 以 注意 到 ， 这 个 解析 用 的 线程 类 所 需要 解析 的 输入 流 是 通过 构造 方法 参数 的 形式 传 
入 的 ， 因 此 它 可 以 用 另 一 种 方式 复 用 ， 只 需要 在 创建 线程 的 时 候 更 改 输入 流 即 可 。 

文档 的 解析 功能 用 到 了 如 下 一 些 包 : 


01 
02 
03 
04 
05 
06 
07 
08 


import 
import 
import 


import 
import 
import 
import 


javax.xml .parsers.DocumentBuilder; 
javax.xml .parsers.DocumentBuilderFactory; 
javax.xml .parsers.ParserConfigurationException; 


org.w3c.dom.Document; 
org.w3c.dom.Node; 
org.w3c.dom.NodeList; 
org.xml .sax.SAXException; 


利用 这 些 包 提供 的 类 和 接口 可 以 方便 地 对 符合 xml 规范 的 文档 进行 解析 ， 在 
TrackThread 线程 的 run0) 方 法 中 包含 了 对 kml 文档 进行 解析 的 代码 ， 如 下 : 


01 public void run() { 
DocumentBuilderFactory docBuilderFactory = DocumentBuilderFactory. 


02 


*366°* 


newInstance (); // 文 档 构造 器 工厂 
DocumentBuilder docBuilder; // 文 档 构 造 器 
Document doc = null; // 文 档 对 象 
| 


docBuilder = docBuilderFactory .newDocumentBuilder(); 


// 从 文档 构造 器 工厂 获取 文档 构造 器 
doc = docBuilder.parse (mTrackPointInputStream); 
// 解 析 输 入 流 ， 生 成 文档 对 象 


} catch (Exception e) { 


by 


e.printstackTrace (); 


NodeList geoPointList = doc.getElementsByTagName ("LineString"); 


// 根 据 标签 名 获取 元 素 列表 


for (int indexOfLine=0; indexOfLine< geoPointList.getLength(); 
indexOfLine++){// 依 次 解析 节点 列表 


Node coordinatesNode = geoPointList.item(indexOfLine); 


// 获 取 要 解析 的 节点 
String[] coordinates = coordinatesNode.NodegetTextContent () . 
BD AEs // 以 空格 分 隔 字符 串 
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15 for (int index = 0; index < coordinates.length - 1; index++){ 
// 解 析出 经 纬 数据 

16 String lon lat alt= coordinates[index]; 

17 int lon=(int) (Double.parseDouble (lon lat alt "plit(™ 
[0])*1e6); // 经 度 

18 int lat=(int) (Double.parseDouble(lon lat alt. 
split(",") [1])*1e6); // 纬 度 

19 currentPoint = new GeoPoint (lat,1lon); // 新 建 GeoPoint 对 象 

20 Message msg = new Message(); // 新 建 消息 

Fa msg-what = MapViewDemo -MESSRAGE TRACK; // 定 义 消息 类 型 

22 msg.obj = currentPoint; // 将 GeoPoint 对 象 存 入 消息 

23 mHandler.sendMessage (msg) // 发 送 消息 

24 } 

之 本 } 

-4 


其 中 ， 第 02 一 10 行 的 代码 根据 文档 输入 流 实例 化 了 Document 对 象 ， 第 11 一 18 行 代 
码 则 是 具体 的 解析 过 程 。 首 先 通过 指定 的 LineStrin 标签 获取 到 包含 有 coordinates 数据 的 
LineString 节点 (第 11 行 ); 使 用 NodeList.item(index) 方 法 获取 到 LineString 节点 下 的 
coordinates 节点 (第 13 行 ); 使 用 Node.getTextContent0) 方 法 以 字符 串 的 形式 获取 到 节点 下 
的 字符 内 容 ， 再 借助 字符 串 的 String.split0 方 法 ， 以 空格 “ ”为 分 隔 符 ， 得 到 一 个 包含 若 
经度、 纬度 和 海拔 数据 的 字符 串 数组 〈 第 14 行 ); 依次 从 解析 得 到 的 字符 串 数组 中 的 每 
-个 字符 串 中 提取 出 经 纬度 值 ， 并 且 形 成 GeoPoint 对 象 〈 第 15 一 18 行 ); 最 后 ， 使 用 前 面 
常用 到 的 方式 ,将 GeoPoint 对 象 用 Message 封装 并 通过 Handler 发 送 给 主线 程 处 理 ( 第 19 一 
23 行 )。 这 里 为 Message 定义 了 一 种 新 的 类 型 MESSAGE_TRACK。 


4. 实现 用 于 绘制 轨迹 的 类 


仅仅 有 了 能 够 解析 文件 的 类 还 不 能 够 完成 轨迹 绘制 的 功能 ， 还 需要 一 个 类 用 于 根据 获 
得 的 一 系列 点 来 绘制 轨迹 ， 为 此 需要 实现 一 个 具有 如 下 功能 的 类 : 

口 有 一 个 列表 用 于 保存 一 系列 GeoPoint 对 象 。 

口 需要 提供 一 个 用 于 向 列表 中 添加 新 的 GeoPoint 的 接口 方法 。 

口 当 有 新 的 GeoPoint 添加 至 列表 中 时 ， 能 够 绘制 出 新 的 轨迹 。 

在 前 面 已 经 提 到 ， 轨 迹 可 以 用 Overlay 的 方式 来 实现 ， 即 轨迹 作为 一 个 独立 的 图 层 位 
于 MapView 上 方 ， 为 此 ， 通 过 继承 Overlay 类 来 实现 满足 上 述 功能 的 Track 类 ， 其 构造 方 
法 如 下 : 


01 List<GeoPoint> points; 

02 Paint paint; 

03 

04 ee 

05 * 构造 函数 ， 使 用 GeoPoint List 绘制 轨迹 
06 * @param points GeoPoint 的 List 

07 */ 

08 public Track(List<GeoPoint> points) { 
09 this.points = points; 

10 paint = new Paint(); 

和 paint.setColor (Color.BLUE); // 画 笔 设 置 为 蓝 色 
4 paint.setAlpha(150); 


// 透 明度 为 150， 注 : 0 一 255 从 小 到 大 由 全 透明 变化 为 不 透明 
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二 
dD 


paint.setAntiAlias (true); // 画 笔 抗 锯齿 
paint-setStyle(Paint-Style-FILL AND STROKE) ; ， // 设 置 画 笔 风格 
paint.setSstrokeWidth (2); // 画 笔 线条 宽度 


/** 

* 使 用 GeoPoint 的 List 和 Paint 对 象 来 绘制 轨迹 

* @param points GeoPoint 的 List， 所 有 的 拐点 

* @param paint Paint 对 象 ， 用 来 控制 划 线 样式 

*/ 

public Track (List<GeoPoint> points, Paint paint) { 
this.points = points; 
this.paint = paint; 


} 


Track 类 提供 了 两 个 构造 方法 ,第 一 个 只 需要 传 入 一 个 List<GeoPoint> 类 型 的 参数 ， 并 
且 使 用 默认 的 Paint 对 象 来 绘制 轨迹 ;第 二 个 构造 方法 则 可 以 自 定义 Paint 对 象 .另外 , Track 
类 还 提供 了 两 个 方法 ， 分 别 用 于 向 列表 中 添加 新 的 GeoPoint 和 根据 列表 来 绘制 轨迹 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 


10 
el 
站 名 


让 | 
14 


15 


16 
人 
18 
9 
20 
2 


public void addPoints (GeoPoint p){ 
this.points.add (p) ;// 将 新 的 GeoPoint 添加 到 列表 
| 


// 真 正 将 线 绘制 出 来 只 需 将 线 绘制 到 canvas 上 即 可 , 主要 是 要 转换 经 纬度 到 屏幕 坐标 
@Override 
Public void draw(Canvas canvas, MapView mapView, boolean shadow) { 
if (!shadow) { 
Projection projection = mapView.get- 
Projection(); //projection 用 于 转换 经 纬度 到 屏幕 点 
if (points != null) { 
if (points.size() >= 2) {// 两 点 以 上 才能 形成 线段 
Point start = projection.toPixels (points.get (0), 
null); // 前 一 个 点 为 线段 起 点 
EOr (int 二 二 二 <DOiRES2SLZeUNR THE 1 
Point end = projection.toPixels (points.get (i), 


null1); // 后 一 个 点 为 线段 终点 
canvas.drawLine(start.x, start.y, end.x, 
end.y, paint); // 画 出 线段 


start = end;// 前 一 条 线段 的 终点 作为 下 一 条 线段 的 起 点 


} 


绘制 轨迹 的 过 程 是 ， 先 判断 列表 中 是 否 有 两 个 以 上 的 点 (第 11 行 )， 然 后 依次 两 两 取 





点 , 经 过 经 纬度 到 屏幕 像素 的 转换 工作 后 (第 12 行 ), 依次 一 段 一 段 地 绘制 出 来 (第 13 一 
17 行 )。 





5. 实现 轨迹 绘制 


在 前 面 实现 的 解析 类 和 绘制 类 的 基础 上 ， 对 MapViewDemo 稍 作 修改 ， 就 可 以 将 轨迹 
绘制 在 MapView 上 。 在 完成 轨迹 绘制 的 过 程 中 这 几 个 类 之 间 的 关系 如 图 8.48 所 示 。 
如 图 8.48 所 示 ， 首 先 在 MapViewDemo 中 打开 test.kml 文件 并 获取 文件 输入 流 ， 并 构 
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造 一 个 解析 类 线程 对 象 ， 将 文件 输入 流 和 mHandler 传 入 : 





































draw() 
test.kml 
GeoPoint GeoPoint 
MapViewDemo = Track MapView 
InputSt ; 
a GeoPoint 





TrackThread 














图 8.48 ” 几 个 类 在 绘制 轨迹 中 的 关系 


01 private TrackThread trackThread; 

02 EET 

03 ryt 

04 trackThread = new TrackThread (getAssets() .open("test.kml"), 
ndler); // 实 例 化 线程 

05 trackThread.start (); // 执 行 线程 开始 解析 

06 } catch (IOException e) { 

07 e.printStackTrace (); 

08 } 


解析 线程 对 象 trackTread 将 会 在 线程 内 部 对 输入 流 进行 解析 ， 并 且 每 解析 出 一 个 
GeoPoint 对 象 ， 就 通过 mHandler 癌 MapViewDemo 发 送 Message， 因 此 ， 在 mHandler 的 
消息 处 理 中 加 入 新 的 消息 处 理 机 制 ; 


01 // 用 于 处 理由 Thread 发 来 的 消息 
02 mHandler = new Handler() { 


03 public void handleMessage (Message msg) { 
04 switch (msg.what) 
05 { 
06 ee 
07 case MESSRGE TRRCK: // 表 示 新 处 理 的 消息 携带 了 用 于 绘制 轨迹 的 点 
08 GeoPoint currentGeoPoint = (GeoPoint)msg.obj;// 获 取 点 
09 mapController.animateTo (currentGeoPoint); 
// 屏 幕 中 心平 移 到 新 点 的 位 置 
10 track.addPoints (currentGeoPoint); // 新 点 添加 到 列表 中 
LE break; 
1 default: 
3 break; 
14 } 
5 super.handleMessage (msg); 
16 
2 


从 代码 中 可 以 看 出 对 MESSAGE_TRACK 消息 的 处 理 方式 : 从 接收 到 的 msg 对 象 中 取 
出 GeoPoint 对 象 ， 然 后 使 用 mapController 将 视图 居中 至 新 地 点 ， 然 后 使 用 track 对 象 的 
addPoints 方法 将 新 取出 的 GeoPoint 加 入 到 track 的 List<GeoPoin 他 列表 中 ， 之 后 便 由 track 
对 象 的 draw 方法 来 负责 绘制 轨迹 。 
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示例 之 所 以 将 解析 文件 的 功能 放 在 一 个 单独 的 线程 中 来 实现 ， 是 因为 这 种 方式 与 实际 
应 用 中 的 轨迹 绘制 方式 相似 。 在 实际 应 用 中 ， 通 常 也 可 以 开启 一 个 单独 的 线程 ， 专 用 于 从 
GPS 模块 获取 新 获得 的 GPS 数据 , 然后 按照 类 似 于 本 示例 的 方式 , 将 新 获取 的 数据 传 给 主 
线程 ， 然 后 让 主线 程 和 Track 类 来 负责 轨迹 的 绘制 。 读 者 可 以 自行 修改 一 下 示例 ， 实 现 从 
真 机 中 获取 新 的 位 置信 息 的 功能 ， 然 后 放 到 真 机 中 进行 验证 ， 看 是 否 能 够 正确 地 绘制 出 
轨迹 。 


84 基站 应 用 


基站 (Base Station， 缩 写 BS)， 即 公用 移动 通信 基站 。 从 狭义 上 讲 ， 它 是 无 线 电台 站 
的 一 种 形式 ， 指 在 一 定 的 无 线 电 履 盖 区 中 ， 通 过 移动 通信 交换 中 心 ， 与 移动 电话 终端 之 间 
进行 信息 传递 的 无 线 电 收 发 信 电 台 ， 有 具体 就 是 固定 在 一 个 地 方 的 高 功率 、 多 信道 双向 无 线 
电 发 送 机 。 

从 广义 上 讲 ， 它 是 基站 子 系统 (BSS，Base Station Subsystem) 的 简称 。 以 GSM 网 络 
为 例 ， 包 括 基 站 收发 信 机 (BTS) 和 基站 控制 器 (BSC)。 一 个 基站 控制 器 可 以 控制 十 几 个 
甚至 数 十 个 基站 收发 信 机 。 通 常 ， 基 站 的 用 途 是 为 手机 提供 无 线 通讯 信号 以 及 作为 无 线路 
由 器 使 用 。 当 用 户 使 用 手机 进行 通话 或 者 无 线 上 网 时 ， 数 据 就 会 通过 附近 的 一 个 基站 进行 
发 送 和 接收 ， 手 机 正 是 通过 基站 接 入 到 电话 网 络 中 的 。 

通常 ， 基 站 由 移动 通信 运营 商 申 请 设置 。 移 动 通信 基站 的 建设 是 我 国 移动 通信 运营 商 
投资 的 重要 部 分 ， 移 动 通信 基站 的 建设 一 般 都 是 围绕 覆盖 面 、 通 话 质量 、 投 资 效益 、 建 设 
难 易 、 维 护 方便 等 要 素 进 行 。 随 着 移动 通信 网 络 业 务 向 数据 化 、 分 组 化 方向 发 展 ， 移 动 通 
信和 基站 的 发 展 趋势 也 必然 是 宽带 化 、 大 覆盖 面 建设 及 IP 化 。 

本 节 首 先 将 介绍 在 Android 操作 系统 中 如 何 获 取 到 当前 基站 信号 的 强度 ， 通 过 实例 让 
读者 “ 近 距 离 ” 地 体会 到 基站 的 存在 ， 同 时 也 能 够 让 读者 熟悉 Android 相关 的 API; 本 节 
的 第 二 小 节 将 介绍 利用 基站 信息 进行 定位 的 方法 ， 这 种 定位 方法 虽然 精度 没有 前 面 介绍 的 
GPS 定位 那么 高 , 但 是 它 可 以 在 手机 没有 GPS 硬件 模块 的 情况 下 为 手机 提供 定位 功能 , 能 
够 覆盖 的 用 户 面 更 广 ， 同 时 也 能 够 弥补 GPS 定位 在 封闭 的 空间 中 不 能 够 正常 工作 的 缺陷 。 
当 我 们 所 要 开发 的 应 用 程序 涉及 到 地 理 位 置 定位 功能 时 , 建议 能 够 在 采用 GPS 定位 的 同时 
也 考虑 基站 定位 ， 使 得 应 用 程序 更 加 健壮 。 





8.4.1 基站 信号 强度 获取 


Android 与 基站 数据 相关 的 包 是 android.telephony 、android.telephonycdma 和 
android.telephony.gsm， 本 小 节 需 要 用 到 的 相关 类 则 是 : 
口 android.telephony.PhoneStateListener: 该 类 用 于 监听 手机 的 一 些 特定 状态 的 变更 事 
件 ， 包 括 了 服务 状态 的 切换 、 信 号 强度 的 变化 、 留 言 信 息 提示 语音 信箱 〉 等 等 
事件 。 
口 android.telephony.SignalStrength: 该 类 用 于 获取 手机 的 信号 强度 相关 信息 ， 包 括 了 
GSM 信号 和 CDMA 信号 的 强度 相关 信息 。 本 小 节 以 GSM 信号 强度 为 例 ， 根 据 
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SignalStrength 类 的 说 明文 档 所 述 ，GSM 信号 强度 值 包括 0~31、99 这 33 个 有 效 
数值 ， 它 们 所 对 应 的 含义 在 编号 为 TS 27.007 的 文件 的 8.5 节 的 内 容 中 被 定义 (使 
用 Google 搜索 “TS 27.007 8.5” 就 能 够 找到 这 个 文件 )， 这 个 文件 由 3GPP 维护 。 
具体 地 , 数值 0 代表 信号 强度 为 -113dBm 或 更 弱 , 数值 1 代表 信号 强度 为 -111dBm， 
数值 2 一 30 代表 信号 强度 为 -109 一 -53dBm， 数 值 31 代表 信和 号 强度 为 -31dBm 或 更 
大 ， 数 值 99 则 代表 当前 的 信号 强度 未 知 或 者 不 能 被 检测 。 

口 android.telephony.TelephonyManager: 该 类 提 
供 了 用 于 访问 设备 的 通话 通信 服务 相关 信息 
的 方法 ， 在 应 用 程序 中 可 以 使 用 该 类 提供 的 
方法 来 获取 通话 通信 服务 信息 以 及 状态 信 
息 ， 例 如 获取 本 机 号 码 、 当 前 连接 的 基站 信 
息 、 手 机 类 型 、Sim 卡 序列 号 、 当 前 使 用 的 数 
据 状 态 等 等 。 该 类 还 提供 了 一 个 名 为 listen 的 
方法 用 于 为 特定 的 事件 变更 注册 监听 器 ( Ma! 
PhoneStateListener)， 本 小 节 中 要 使 用 到 的 就 
是 这 个 方法 。 

1. 获取 基站 信号 强度 示例 效果 


接 下 来 就 来 实现 一 个 能 够 检测 信号 强度 变化 并 且 
输出 相应 强度 值 的 例子 ， 例 子 项 目的 名 称 为 
GetSignalStrength， 该 项 目的 效果 如 图 8.49 所 示 。 

os 例 项 目的 运行 结果 ， 由 于 示例 是 图 8.49 获取 信号 强度 
运行 在 模拟 器 上 ， 因 此 其 信号 强度 为 不 可 测 状 态 ， 所 
以 图 中 显 ns 号 强度 值 为 99。 下 面 来 介绍 一 下 本 示例 的 具体 实现 。 


2. 代码 实现 








在 最 开始 需要 修改 的 是 该 项 目的 AndroidManifest.xml 文件 , 目的 是 为 应 用 程序 申请 足 
够 的 权限 。 由 于 该 应 用 程序 要 监听 信和 号 强度 ， 这 属于 网 络 状态 改变 权限 ， 因 此 需要 在 
AndroidManifest.xml 文件 中 增加 如 下 一 行 代码 如 下 : 


<uses-permission android:name="android.permission.CHANGE NETWORK STATE" /> 





然后 , 需要 实现 的 是 用 于 监听 信和 号 强度 变化 事件 的 监听 器 , 接着 使 用 en 
的 listen 方法 将 这 个 监听 器 与 需要 监听 的 具体 事件 关联 注册 即 可 。 入 通过 继承 
PhoneStateListener 类 并 重 写 其 方法 来 实现 自己 的 监听 器 ， 此 处 需要 本 了 的 方法 是 
onSignalStrengthsChanged0) 方 法 ， 代 码 如 下 : 


01 private class MyPhoneStateListener extends PhoneStateListener { 





02 private Handler mHandler; // 用 于 向 主线 程 发 送 消 息 

03 

04 public MyPhoneStateListener (Handler handler) {// 构 造 方法 
05 this.mHandler = handler; 

06 } 

(oh 
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08 Q@Override 
09 Public void onSignalStrengthsChanged (SignalStrength 
signalstrength) // 信 号 强度 改变 时 被 调用 
10 { 
11 super.onSignalStrengthsChanged (signalstrength); 
12 final int signalStrengthValue = signalStrength . 
getGsmSignalStrength() ; // 获 取 当 前 信号 强度 
3 mHandler.post (new Runnable() { 
14 
Q@Override 
16 public void run() { 
小 strengthValue.setText (signalStrengthValue + ""); 
// 更 新 视图 显示 
18 } 
19 ]) 7 
20 Toast.makeText (getApplicationContext () ，" 当 前 信号 强度 = " 
// 使 用 Toast 消息 显示 
2 + String.valueOf (signalStrength.getGsmSignal- 
strength()), 
之 2 Toast.LENGTH SHORT) .show() 
这 3 } 
2 


其 中 ， 该 类 的 成 员 变 量 mHandler 用 于 在 非 UI 线程 中 更 新 UI 控件。 第 12 行 是 获取 当 
前 信号 强度 的 关键 代码 ， 其 中 signalStrength 是 作为 参数 传 入 的 ， 当 信和 号 强度 发 生变 化 时 ， 
系统 会 调用 onSignalStrengthsChanged 方法 并 且 传 入 这 个 包含 有 当前 信号 强度 信息 的 对 象 ， 
从 而 使 得 程序 具有 实时 获取 信号 强度 的 功能 。 

在 实现 了 MyPhoneStateListener 之 后 ， 只 需要 在 Activity 的 onCreate() 方 法 中 实例 化 该 
listener 并 且 注 册 到 系统 中 即 可 ， 代 码 如 下 : 


01 Q@Override 
02 public void onCreate (Bundle savedInstanceState) { 








03 super .onCreate (savedInstanceState) 7 
04 setContentView(R.layout .main) 
05 strengthValue = (TextView) findViewById(R.id.strengthvalue) 
06 mHandler = new Handler(); 
07 mpPhoneStateListener = new MyPhoneStateListener (mHandler) 

// 实 例 化 信号 强度 变化 监听 器 
08 // 获 取 与 信号 相关 的 管理 器 
09 mTelephonyManager = (TelephonyManager)getSystemService (Context . 

TELEPHONY SERVICE) 

10 mTelephonyManager .listen (mPhoneStateListener, 

// 注 册 监 听 器 ， 用 于 监听 信号 强度 变化 
Ep PhoneStateListener.LISTEN SIGNAL STRENGTHS); 
2 
13 Q@Override 
14 protected void onPause(){ //Activity 暂停 时 ， 解 除 监听 器 注册 
15 Super .onPause (); 
16 mTelephonyManager .listen (mPhoneStateListener, Phone- 

StateListener .LISTEN NONE) : 

ER 
18 
19 Q@Override 
20 protected void onResume(){ //Activity 继续 执行 时 ， 重 新 注册 监听 器 
这 super -onResume () 
之 mTelephonyManager .listen (mPhoneStateListener, 
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23 PhoneSstateListener.LIISTEN SIGNAL STRENGTHS); 

pd po; 

如 上 段 代 码 , 第 07、09 行 分 别 实例 化 了 PhoneStateListener 和 TelephonyManager 对 象 ; 
第 10、11 行 则 是 对 监听 器 进行 注册 ， 用 于 监听 PhoneStateListenerLISTEN 
SIGNAL _ STRENGTHS 事件 ， 即 信号 强度 变更 事件 。 后 半 部 分 重 写 的 onPause() 方 法 和 
onResume() 方 法 的 作用 是 在 应 用 程序 不 在 最 上 时 停止 对 信号 强度 变化 的 监听 。 


8.4.2 ”基站 定位 


使 用 基站 进行 定位 一 般 被 手机 用 户 所 使 用 , 与 GPS 一 样 , 手机 基站 定位 服务 又 叫做 移 
动 位 置 服务 (LBS 一 一 Location Based Service)， 它 是 通过 电信 移动 运营 商 的 网 络 (如 GSM 
网 ) 获取 移动 终端 用 户 的 位 置信 息 〈 经 纬度 坐标 )， 在 电子 地 图 平台 的 支持 下 ， 为 用 户 提供 
相应 服务 的 一 种 增值 业务 ， 如 目前 中 国 移动 动感 地 带 提 供 的 动感 位 置 查询 服务 等 。 

其 大 致 原理 为 :移动 电话 测量 不 同 基站 的 下 行 导 频 信 号 ， 得 到 不 同 基站 下 行 导 频 的 
TOA〈Time of Arrival， 到 达 时 刻 )， 根 据 该 测量 结果 并 结合 基站 的 坐标 ， 一 般 采 用 三 角 公 
式 估计 算法 ， 就 能 够 计算 出 移动 电话 的 位 置 。 实 际 的 位 置 估计 算法 需要 考虑 多 基站 (3 个 
或 3 个 以 上 ) 定位 的 情况 ， 因 此 算法 要 复杂 很 多 。 一 般 而 言 ， 测 量 的 基站 数目 越 多 ， 测 量 
精度 就 越 高 ， 定 位 性 能 的 改善 也 就 越 明显 。 

与 基于 GPS 定位 的 方式 不 同 ， 基 于 GPS 的 定位 方式 是 利用 手机 上 的 GPS 定位 模块 将 
自己 的 位 置信 号 发 送 给 系统 来 实现 手机 定位 的 ， 基 站 定位 则 是 利用 基站 对 手机 的 距离 来 确 
定 手机 位 置 的 。 后 者 不 需要 手机 具有 GPS 定位 能 力 , 但 是 精度 很 大 程度 依赖 于 基站 的 分 布 
及 禾 盖 范围 的 大 小 ， 有 时 误差 会 超过 一 公里 。 一 般 来 说 ， 前 者 的 定位 精度 较 高 。 

鉴于 基站 定位 与 GPS 定位 的 异同 ， 在 实际 应 用 中 通常 对 基站 定位 有 如 下 两 点 要 求 ; 

口 较 高 的 覆盖 率 : 一 方面 ， 要 求 基站 定位 覆盖 的 范围 足够 大 ， 另 一 方面 则 要 求 覆 盖 

的 范围 包括 室内 (GPS 定位 在 室内 会 失效 )。 用 户 大 部 分 时 间 是 在 室内 使 用 该 功能 ， 
从 高 层 建筑 到 地 下 设施 必须 保证 覆盖 到 每 个 角落 。 手 机 定位 根据 覆盖 率 的 范围 ， 
可 以 分 为 3 种 获 盖 率 的 定位 服务 ， 整 个 本 地 网 、 和 覆盖 部 分 本 地 网 和 提供 漫游 网 络 
服务 类 型 。 除 了 考虑 覆盖 率 外 ， 网 络 结构 和 动态 变化 的 环境 因素 也 可 能 使 一 个 电 
信和 运营 商 无 法 保证 在 本 地 网 络 或 漫游 网 络 中 的 服务 。 
口 一 定 的 定位 精度 : 手机 定位 应 该 根据 用 户 服务 需求 的 不 同 提供 不 同 的 精度 服务 ， 
并 可 以 提供 给 用 户 选择 精度 的 权利 。 例 如 美国 FCC 推出 的 定位 精度 在 50 米 以 内 
的 概率 为 67%， 定 位 精度 在 150 米 以 内 的 概率 为 95%。 定 位 精度 一 方面 与 采用 的 
定位 技术 有 关 ， 另 外 还 取决 于 提供 业务 的 外 部 环境 ， 包 括 无 线 电 传播 环境 、 基 让 
的 密度 和 地 理 位 置 ， 以 及 定位 所 用 设备 等 。 当 我 们 的 手机 里 装 上 中 国 移动 或 者 中 
国电 信 的 卡 后 ， 就 可 以 利用 中 国 移动 或 者 中 国电 信 基 站 进行 定位 了 ， 这 种 定位 误 
差 相 对 较 大 ， 但 是 盲区 相对 较 小 ， 只 要 有 电话 信号 的 地 方 都 可 以 实现 定位 。 现 在 
大 部 分 手机 都 采用 了 GPS 定位 与 基站 定位 相 结 合 来 实现 相对 精度 更 高 的 定位 模 
式 ， 在 这 种 模式 下 可 以 让 手机 在 室外 有 卫星 信号 的 地 方 采用 GPS 卫星 定位 ， 误 差 
在 10~50 米 左右 ; 当 手 机 进入 到 地 下 停车 场 或 者 室内 的 无 法 接收 到 GPS 卫星 信号 
的 地 区 时 ， 定 位 方式 就 自动 转换 到 基站 模式 ， 通 过 这 样 的 方式 来 达到 定位 精度 与 
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履 盖 率 的 最 优 。 
本 小 节 将 介绍 在 Android 中 如 何 利用 基 * 
的 Web 服务 API〈 这 个 Web 服务 本 身 搜 集 了 全 球 非常 全 面 的 基站 相关 数据 ， 该 服务 使 用 
JSON 格式 文件 进行 请 求 和 数据 输出 )， 利 用 手机 当前 的 GsmCellLocation 信息 (通过 
android .telephony.TelephonyManager 类 的 getCellLocation() 方 法 来 获取 ) 来 计算 出 当前 的 经 
纬 数据 ， 然 后 再 利用 Google 地 图 API 根据 经 纬 数 据 得 出 对 应 的 地 址 信息 。 


1. 示例 效果 








示例 效果 如 图 8.50 和 图 8.51 所 示 。 
中 


BaseStationLocate 
定位 结 
点 击 技 钮 进行 定位 


中 会 川 四 11:10 


BaseStationLocate 


中 国 四 川 省 广安 市 广安 区 商业 步 
行 街 邮政 编码 : 638000 





图 8.50 程序 初始 界面 图 8.51 基站 定位 结果 
如 上 两 幅 截图 所 示 ， 在 单 击 了 定位 按钮 之 后 ， 得 到 了 当前 手机 所 处 的 地 区 位 置 ， 笔 者 
在 进行 测试 的 时 候 ， 基 站 定位 的 结果 与 实际 地 理 位 置 的 差异 较 大 ， 大 概 在 1 公里 左右 ， 这 
也 是 基站 定位 的 原理 所 决定 的 。 读 者 可 以 在 自己 所 处 的 地 点 测试 该 程序 ， 看 看 定位 的 精确 
度 如 何 。 
2. 代码 实现 





同样 ， 首 先 需 要 满足 的 是 应 用 程序 的 权限 需求 ， 该 程序 需要 访问 互联 网 、 利 用 Cell-id 
进行 定位 、 读 取 设 备 的 状态 等 权限 ， 因 此 需要 在 AndroidManifest.xml 文件 中 添加 如 下 几 行 
代码 ; 

<uses-permission android:name="android.permission.ACCESS CORRSE 

LOCATION™ /> 


<uses-permission android:name="android.permission.READ PHONE STATE" /> 
<uses-permission android:name="android.permission.INTERNET" /> 
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下 面 来 看 Activity 的 代码 ， 正 如 前 面 提 到 的 定位 原理 ， 该 应 用 首先 是 使 用 











TelephonyManager 类 来 获取 到 手机 的 CellLocation 信息 ， 然 后 利用 获取 到 的 信息 在 数据 库 
(由 Google 提供 ， 并 且 以 Web 服务 的 形式 进行 调用 ) 中 进行 查询 ， 查 询 结果 是 一 个 包含 有 
经 纬 数值 的 JSON 文件 , 根据 经 纬 数值 就 能 够 定位 得 到 具体 的 地 址 信息 ,查询 的 代码 如 下 : 


01 


02 


03 


04 


05 


06 





// 通 过 TelephonyManagez 获取 到 GsmCellLocation 对 象 ， 这 个 对 象 包含 了 基站 定位 相 
言 息 
区 gsmCellLocation = (GsmCellLocation) mTelephonyManager. 
getCellLocation(); 
int cid = gsmCellLocation.getCid(); 
// 获 取 Cell-id (基站 编号 ) 值 ， 由 运营 商 提 供 
int lac = gsmCellLocation.getLac(); 
// 获 取 location area code (位 置 区 域 码 ) 值 ， 由 运营 商 提 供 
int mcc = Integer.valueOf (mTelephonyManager .getNetworkOperator () . 
substring (0,3)); // 国 家 代码 
int mnc = Integer.valueOf (mTelephonyManager .getNetworkOperator () . 
substring(3,5)); // 网 络 代码 
try{ 
// 准 备用 于 发 起 JSON 查询 的 内 容 
JSONObject holder = new JSONObject (); 
// 新 建 JSONObject 对 象 ， 用 于 封装 查询 的 内 容 


holder.put ("version", "1.1.0"); // 设 置 版 本 号 
holder.put ("host", "maps.google.com"); // 设 置 主机 地 址 
holder.put ("request address", true); // 设 置 请 求 地 址 标志 为 真 


JSONRrray array = new JSONArray(); // 新 建 JSONArray 对 象 用 于 存放 数组 
JSONObject data = new JSONObject () 


// 新 建 JSONObject 对 象 ， 用 于 封装 基站 信息 


data.put ("cell id", cid); // 设 置 cel1-id 值 
data.put ("location area code", lac); // 设 置 位 置 区 域 码 
data.put ("mobile country code", mcc); // 设 置 国家 代码 
data.put ("mobile network code", mnc); /1 设置 网 络 代码 
array-put (data); // 将 data 存放 为 数组 形式 
holder.put ("cell towers", array); // 设 置 基 站 数据 

// 向 web 服务 发 送 定位 请 求 


DefaultHttpClient client = new DefaultHttpClient (); 

HttpPost Post = new HttpPost("http://www.google.com/loc/json"); 
// 使 用 PosT 方法 发 送 请 求 

StringEntity se = new StringEntity (holder.toString()); 

Post .setEntity(se) : 

HttpResponse httpResponse = client.execute (Post) ; // 执 行 定位 请 求 


// 接 收 并 解析 服务 器 响应 
HttpEntity entity = httpResponse.getEntity(); 
BufferedReader br = new BufferedReader (new InputStreamReader 
(entity.getContent ())); // 获 取 输 入 流 
StringBuffer sb = new StringBuffer(); 
String result = br.readLine(); 
while(result != null){ // 从 输入 流 读 取 结果 

sb.append (result); 

result = br.readLine(); 
} 
JSONObject rawData = new JSONObject (sb.toString() ) > 

// 获 取 原 始 数据 待 解析 


JSONObJject LocationData = new JSONObject (rawData .getString 
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("location™))ys // 解 析 定 位 信息 
40 // 根 据 经 纬度 获取 地 址 
41 getAddress (JocationData.getString("1Latitude") ， 


locationData.getString("longitude")); 
42 Jcatch (Exception e){} 


如 代码 所 示 ， 第 01 一 06 行 获取 了 一 个 GsmCellLocation 类 型 的 对 


象 ， 然 后 从 中 取得 了 


使 用 基站 定位 所 需要 的 一 些 数据 ;然后 在 第 09 一 20 行 代码 里 将 这 些 数据 以 及 其 他 的 一 些 配 
置信 息 封装 成 为 一 个 JSON 文件 ; 第 23 一 27 行 代码 则 是 将 查询 信息 使 用 HttpPost 的 方式 提 


交 给 Web 服务 处 理 ; 最 后 ， 第 30 一 41 行 代码 则 是 接收 从 Web 服务 返 
并 进行 解析 ， 获 取 到 经 纬 数值 后 通过 调用 getAddress( 方 法 〈 第 41 行 
地 址 字符 串 并 且 输 出 到 界面 上 。getAddress() 方 法 的 代码 如 下 : 


01 // 借 助 Google 地 图 Web 服务， 根据 经 纬度 数据 得 到 地 址 名 称 
02 Private void getRddress (String lat, String lag) { 


回 的 JSON 数据 文件 
) 将 经 纬 数 值 转换 为 





// 参 数 为 :纬度 、 经 度 


03 tryt{ 
04 // 生 成 用 于 查询 地 址 的 URL 
05 URL url = new URL("http://maps.google.cn/maps/geo?key= 

abcdefggq='" + lat + "," + lag); 
06 InputStream inputStream = url.openConnection(). 

getInputStream(); // 获 取 输 入 流 
07 InputStreamReader inputReader = new InputStreamReader 

(inputStream， "utf-8"); // 实 例 化 读 入 器 
08 BufferedReader bufReader = new BufferedReader (inputReader); 
09 String line = "", lines = ""; 
10 while((line = bufReader.readLine()) != null){ 

// 读 取 查 询 到 的 结果 
I lines += line; 
业 } 
3 if(!lines.equals("")){ 
14 JSONObject jsonobject = new JSONObject (lines); 
// 生 成 JSONObject 对 象 待 解析 
15 // 解 析 并 得 到 地 址 
16 JSONArray jsonArray = new JSONArray (jsonobject. 
get ("Placemark") .toString()); 
和 for (int i = 0; i < jsonArray.length(); i++) { 
// 显 示 最 终 定位 结果 
18 addressText.setText (addressText.getText() + "\n" 
19 + jsonArray .getJSONObject (i) .getString 
("address")); 

20 } 
wh } 
22 }catch (Exception el) 1{ } 
ee 


这 个 方法 又 用 到 了 另 一 个 Web 服务 ， 即 Google 提供 的 地 图 查询 服务 (第 05 行 )， 来 
将 经 纬 数值 转换 为 地 址 字符 串 并 输出 〈 第 14 一 19 行 )。 至此, 通过 单 击 界面 上 的 定位 按钮 ， 





就 能 够 使 用 基站 的 方式 进行 定位 了 。 


本 章 介 绍 了 Android 的 一 些 特色 开发 ， 当 然 这 些 功 能 并 不 是 只 能 够 在 Android 上 实现 ， 
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而 是 Android 很 好 地 支持 了 这 些 特色 功能 的 开发 。 本 章 的 内 容 主 要 包括 了 传感器 的 访问 广 
法 、GPS 功能 的 应 用 以 及 基站 信息 的 获取 和 定位 方法 ， 文 中 介绍 的 这 些 内 容 只 是 一 些 基础 
的 使 用 方法 ， 读 者 在 学 会 了 使 用 这 些 功能 之 后 ， 能 够 发 挥 自己 的 想象 力 和 创造 力 ， 来 自己 
设计 富有 创意 和 实用 价值 的 应 用 程序 才 是 最 关键 的 目的 。 在 学 习 了 本 章 之 后 ， 读 者 应 该 能 
够 充分 地 体会 到 Android 功能 的 丰富 ， 在 之 后 的 开发 过 程 中 也 能 够 让 应 用 程序 更 加 的 丰富 
多 彩 。 














8.6 习 题 


【习题 1】 结 合 8.1 节 的 内 容 ， 获 取 使 用 的 真 机 的 传感器 清单 。 
【习题 2】 结 合 指南 针 应 用 的 相关 内 容 ， 添 加 当前 方向 说 明 功 能 。 
外 提示 : 方向 说 明 即 是 北 偏 东 30 类 似 的 说 明 ， 该 说 明 直 接 根据 返回 的 Z 轴 数 组 values[0] 
值 即 可 。 
【习题 3】 结 合计 步 器 的 相关 内 容 ， 实 现 统计 单位 时 间 内 所 走 的 步 数 。 
全 提示 : 通过 计 步 器 的 实例 已 经 实现 了 统计 总 步 数 的 功能 ， 统 计 单 位 时 间 步 数 需要 记录 所 
使 用 的 时 间 。 可 以 记录 计 步 开始 时 间 和 终止 时 间 ; 也 可 以 每 间隔 一 分 钟 获 取 当 前 
总 步 数 ， 如 果 一 分 钟 内 总 步 数 为 0 则 不 记录 该 时 间 。 
【习题 4】 结 合 GPS 应 用 的 相关 内 容 ， 实 现 8.2 节 的 内 容 。 
【习题 5】 结 合 GPS 和 基站 的 应 用 ， 实 现 平 时 获取 GPS 位 置信 息 ， 当 无 法 获取 时 获取 
基站 信息 进行 定位 。 
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在 前 面 的 章节 中 ， 我 们 介绍 的 Android 开发 都 是 使 用 Java 来 进行 的 ， 不 过 类 似 Java 
这 样 基 于 虚拟 机 的 语言 在 运行 上 比 基 于 C 语言 或 C++ 语言 的 效率 要 低 。 在 高 清 视频 播放 、 
图 形 图 像 浑 染 等 情况 下 ， 效 率 是 不 能 满足 用 户 需求 的 ， 甚 至 产生 严重 的 失真 、 丢 帧 、 卡 机 
等 现象 。 而 且 ， 很 多 工具 都 可 以 对 Java 代码 进行 反 编 译 ， 并 且 反 编译 的 结果 和 原始 代码 的 
相似 度 极 高 ， 不 能 保证 自身 代码 的 保密 性 和 安全 性 。 

对 于 这 样 的 情况 ， 我 们 需要 Android 对 C、C++ 语 言 的 支持 。Android 提供 了 NDK 来 
实现 对 C、C++ 语 言 的 支持 ， 从 一 定 程度 上 解决 了 以 上 两 大 问题 。 在 本 章 中 ， 我 们 将 介绍 
NDK 开发 环境 的 搭建 并 通过 实现 基本 的 NDK 程序 来 讲解 NDK 代码 的 编写 。 


9.1 Windows 下 NDK 开发 环境 搭建 


Android NDK (Native Development Kit， 原 生 开 发 工具 包 ) 是 一 系列 工具 的 集合 ， 这 
些 工 具 能 够 帮助 开发 者 快速 开发 C 或 C++ 动态 库 ， 并 能 自动 将 so 和 Java 应 用 一 起 打包 成 
应 用 程序 包 apk。 NDK 集成 了 交叉 编译 器 ,并 提供 了 相应 的 mk 文件 隔离 CPU、 平台 、ABI 
等 差异 ， 开 发 人 员 通 过 修改 mk 文件 ， 就 可 以 创建 出 so 文件 。 

so 文件 是 一 种 标准 的 Linux 执行 文件 ELF (Executable and Linkable Format， 可 执行 连 
接 格式 ) 格式 的 文件 ， 类 似 于 Windows 系统 下 的 dll 文件 。 利 用 so 可 以 节约 资源 、 加 快速 
度 、 代 码 升级 简化 。 

这 样 就 实现 了 Android 应 用 程序 运行 在 Dalvik 虚拟 机 中 使 用 Java 代码 , 对 于 需要 高 效 
运算 的 部 分 ， 通 过 NDK 使 用 C/C++ 本 地 代码 来 实现 。 

使 用 NDK 开发 ， 其 依赖 的 环境 比较 多 ， 接 下 来 ， 我 们 一 步 一 步 地 实现 在 Windows 平 
台中 其 开发 环境 的 搭建 。 为 了 顺利 搭建 NDK 开发 环境 ， 请 先 确定 你 已 经 进行 了 基本 的 
Android 开发 环境 的 搭建 ， 安 装 了 Eclipse 3.6 以 上 版 本 以 及 Android SDK。 


9.1.1 下 载 Android NDK 


安装 Android NDK 非常 简单 ， 仅 仅 需 要 从 Android 官网 下 载 对 应 操作 系统 的 NDK 压 
缩 包 , 并 解压 缩 至 任意 目录 即 可 .在 NDK 官方 下 载 页 面 http://developer.android.com/sdk/ndk/ 
index.html 下 载 最 新 版 本 的 NDK 安装 包 ， 对 于 Windows 平台 ， 选 择 对 应 的 Windows 平台 
包 ， 如 图 9.1 所 示 。 
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an53oD 


developers 


Home 


Android SDK Starter Package 


Download 
Installing the SDK 
Downloadable SDK Components 
Adding SDK Components 
» Android 4.0 Platform new 
» Android 3.2 Platform 
» Android 3.1 Platform 
Androld 30 Platform 
Androld 2.3.4 Platform 
» Android 23.3 Platform 
» Android 2.2 Platform 
» Android 2.1 Platform 
» Other Platforms 


SDK Tools, ri 5 new 
Google USB Driver, r4 
Support Package, r4 ew 


ADT Plugin for Eclipse 
ADT15.01 mW 


Native Developinent Tools 


Whatis the NDK? 





Soeh dovelope 





Download the Android NDK 


The Android NDK is a companion tool to the Android SDK that lets you build performance-critical portions of your apps in ns 
libraries that allow you to build activities, handle user input, use hardware sensors, access application resources, and more 
write natve code, your applications are still packaged into an .apk fle and they still run inside of a virtual machine on the de 
application model does not change. 


Using native code does not result in an automatic performance increase, but always increases application complexity, If yo 
the Android framework APls, you probably do not need the NDK Read What is the NDK? for more information about what 让 
useful to you. 


The NDK is designed for use ony in conjunction with the Android SDK If you have not already installed and setup the Andrc 
downloading the NDK. 


Windows 81270552 bytes 55463482cf2b75eBdd1a5d9a7caebBe5 


Mac OS x (nten android-ndk-r7-darwin-x86.tar bz2 71262092 bytes 817ca5675a1dd44078098e43070fl9b6 





Linux 32/64-bit (x86) androidndk-7-inuxx66 tar bz2 。 64884365 bytes bfi5e6b47b50824c4b96849bD03ca3 


图 9.1 NDK 下 载 


下 载 后 解压 缩 到 你 的 工作 目录 ， 如 E:\Android\tools\android-ndk-r7， 如 图 9.2 所 示 。 
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其 它 位 置 


[1] tools 
文档 
占 # 芝 六 簿 





tion. htnl 
Dpera Web Docunent 
1w 


图 9.2 NDK 目录 


在 Android NDK 目录 中 包含 build、docs、samples、sources、GNUmakefile、ndk-build、 
ndk-gdb 及 readme 等 目录 。 其 中 ，samples 目录 下 面包 含 了 几 个 实例 开发 演示 项 目 ， 第 一 次 
接触 NDK 开发 ， 建 议 先 从 示例 开始 。 
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9.1.2 下 载 安装 Cygwin 


由 于 NDK 开发 大 都 涉及 到 C/C++ 在 GCC 环境 下 编译 、 运 行 。 生 成 的 so 文件 是 一 种 
标准 的 Linux 执行 文件 ELF， 所 以 在 Windows 环境 下 ， 需 要 模拟 Linux 的 编译 环境 。 

Cygwin 便 是 一 个 在 Windows 平台 上 模拟 Linux 运行 环境 的 工具 ， 是 cygnus solutions 
公司 开发 的 自由 软件 ,也 是 我 们 在 Windows 平 台中 开发 NDK 应 用 必 不 可 少 的 工具 。Cygwin 
的 安装 步骤 如 下 : 


1. 下 载 Cygwin 


进入 Cygwin 的 官方 主页 http:/www.cygwin.com， 在 网 站 首页 左 方 的 导航 栏 里 单 击 
Install Cygwin 进入 安装 指引 页 面 。 在 该 页 面 可 以 找到 Cygwin 的 安装 程序 setup.exe 的 下 载 ， 
链接 ， 单 击 进行 下 载 ， 如 图 9.3 所 示 。 


2. 安装 Cygwin 


下 载 Cygwin 安装 程序 后 ， 双 击 安装 程序 ， 进 入 正式 的 安装 过 程 。 根 据 安 装 向 导 ， 我 
们 需要 注意 以 下 几 点 。 

(1) 选择 安装 方式 : 

第 一 次 安装 可 以 采用 Direct Connection 进行 在 线 下 载 安装 ， 如 果 已 经 下 载 好 了 现成 的 
离线 包 ， 可 以 选择 离线 安装 〈Install from Local Directory) 。 由 于 是 第 一 次 安装 ， 我 们 选择 
在 线 下 载 安装 ， 如 图 9.4 所 示 。 


[FRRTDE CHOTSPLTESESIISTDT TI 
Choose A Download Source 
Choose whether to nstal or download fom he niemet or install hom flesm 
local drectory. 





rn 
日 Hs: stp ee 
四: 户 艇 
有 量 : opin em 
六 HR 世相， 确定 T 载 ? 














| 本 了 到 本 了 














图 9.3 下 载 Cygwin 图 9.4 安装 方式 


(2) 选择 安装 目录 
单 击 “ 下 一 步 ” 按 钮 后 ， 进 入 安装 目录 的 选择 ， 如 图 9.5 所 示 。 此 目录 是 指 Cygwin 
最 终 的 安装 目录 ， 而 不 是 下 载 的 文件 暂 存 目录 。 例 如 ， 我 们 将 Linux 的 模拟 环境 安装 在 
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Android 目录 中 ， 其 目录 为 E:\Android\cygwin。 





[Er i 中 日 x 


Select Root Install Directory 
Select the drectory where you want to nstal Cygwin, Also choose a few 
instalaton parameters. 





Root Diectoy 
EMndodvagni 














Instal For 
© AlUsers RECOMMENDED) 
Cygwin wl be avalable to al users of the system 


Ouust Me 


Cygwin wil stll be avalable to al users, but Desktop Icons, Cygwin Menu Enties, and 
mportant Installer nfomalion are only avalable to the curent user. 0nb select this 
‘you lack Administrator privieges or if you have speciic needs. 








ZX) we 


图 9.5 安装 目录 


(3) 设置 本 地 包 暂 存 路 径 

单 击 “ 下 一 步 ” 按 钮 后 ， 需 要 选择 下 载 文件 的 暂 存 目录 。 该 目录 默认 放 到 setup.exe 的 
同 级 目录 下 ， 一 般 不 需要 改变 ， 如 图 9.6 所 示 。 当 下 载 完成 后 ， 下 一 次 安装 时 ， 我 们 就 可 
以 在 安装 方式 中 指定 该 目录 选择 离线 安装 。 


[FDCSETTEUS 可 ETUUDOOTEESOESPEDITETIDT7 辐 回 因 


Select Local Package Directory 
Select a diectory where you want Setup to store the instalation fiest 
downrloads. The drectory wil be created ft does not abeady ent 























图 9.6 下 载 文件 保存 目录 


(4) 设置 网 络 连 接 方 式 
在 线 安装 时 ，Cygwin 提供 了 常用 的 网 络 连 接 方式 ， 包 括 了 直接 连接 、 代 理 连接 等 ， 如 
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图 9.7 所 示 。 在 此 进行 选择 。 
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Select Your Interet Connection 
Setup needs to know how you want it to connect to the ntemet. Choose 
the appropiate setings below, 





OUse Intemet Explorer Prog Setings 
OUseHTTPFTPPowr 





Prow Ho 
Pat 加 














图 9.7 网 络 连接 方式 





(5) 选择 下 载 站 点 地 址 


Cygwin 会 给 
的 163 下 载 地 址 ， 


出 下 载 Linux 文件 的 镜像 地 址 ， 对 于 国内 的 用 户 来 说 ,选择 网 易 公 司 提供 
其 站 点 稳定 并 且 速 度 不 错 ， 如 图 9.8 所 示 。 





(oe) 


Choose A Download Site 
Choose a site from this st, of add your own sites to the st 














图 9.8 下 载 站 点 选择 


(6) 选择 安装 项 


这 一 步 非常 





和 要， 安装 时 需要 特别 注意 。 我 们 编译 NDK， 在 默认 设置 下 ， 只 需 选 择 


Devel。 单 击 列表 中 的 Devel， 将 后 面 的 Default 改 为 Install， 如 图 9.9 中 框 中 所 示 ， 其 他 均 
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以 上 方法 将 下 载 全 部 的 开发 工具 ， 如 果 不 想 全 部 下 载 ， 则 需要 找到 开发 NDK 用 得 着 
的 包 : autoconf2.1、automake1.10、binutils、gcc-core、gcc-g++、gcc4-core、gcc4-gt++、gdb、 
pcre、pcre-devel、gawk、make 共 12 个 包 。 


Select Packages 
Select packages to instal 








图 9.9 选择 安装 项 


(7) 下 载 完成 

下 载 这 些 安装 包 ， 一 般 需 要 3 一 4 个 小 时 。 如 果 选 择 完全 下 载 所 有 的 包 ， 下 载 的 压缩 
包 大 小 约 830M。 当 下 载 完成 后 会 自动 安装 到 设置 的 安装 目录 ， 如 图 9.10 所 示 。 当 下 载 完 
成 后 ， 最 好 把 下 载 的 包 目 录 做 个 备份 ， 下 次 安装 同样 的 环境 可 以 直接 使 用 离线 安装 方式 。 
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图 9.10 安装 目录 
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从 图 9.10 中 可 以 看 出 其 目录 结构 和 Linux 的 目录 结构 是 相同 。 


9.1.3 验证 NDK 环境 





1. 验证 Cygwin 编 译 工具 
安装 完 Cygwin 后 ， 运 行 该 软件 。 当 第 一 次 使 用 时 ， 会 创建 一 些 用 户 环境 文件 。 在 弹 





出 的 命令 行 窗 口 输入 Cygcheck -c cygwin 命令 ， 会 打印 出 当前 Cygwin 的 版 本 和 运行 状态 ， 
如 果 status 是 OK 的 话 ， 则 Cygwin 运行 正常 。 运 行 过 程 如 下 : 





$ cygcheck -c cygwin 

Cygwin Package Information 

Package Version Status 
cygwin 1.7.9-1 OK 


当 Cygwin 正常 运行 时 ， 分 别 输入 make-v 和 gcc-v， 验 证 make 和 gcc 是 否 安 装 正确 。 


如 果 检 测 成 功 ， 则 会 有 make 和 gcc 相关 版 本 信息 打印 出 来 ， 运 行 过 程 如 下 : 


$ make -Vv 

GNU Make 3.82.90 

Built for i686-pc-cygwin 

Copyright (C) 2010 Free Software Foundation, Inc. 

License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/ 
gpl.html> 

This is free software: you are free to change and redistribute it. 
There is NO WARRANTY, to the extent permitted by law. 
Owner@lenovo-e536a9ef ~ 

$ gcc-v 

Using built-in specs. 

COLLECT GCC=gcc 

COLLECT LTO WRAPPER=/usr/lib/gcc/i686-pc-cygwin/4.5.3/lto-wrapper.exe 
Target: i686-pc-cygwin 

Configured with: /gnu/gcc/releases/respins/4.5.3-3/gcc4-4.5.3-3/src/gcc-4. 
5.3/configure --srcdir=/gnu/gcc/releases/respins/4.5.3-3/gcc4-4.5.3-3/ 
SFTC/gCC-4.5.3 


Thread model: posix 
gcc version 4.5.3 (GCC) 


2. 编译 NDK 示 例 程 序 


为 了 保证 NDK 的 编译 环境 设置 正确 , 我 们 通过 编译 NDK 中 自 带 的 示例 程序 来 进行 验 
需要 进行 如 下 几 步 : 

(1) 进入 NDK 目录 

由 于 NDK 的 编译 环境 是 在 Cygwin 中 ， 我 们 通过 Cygwin 进入 NDK 的 保存 目录 。 
安装 Cygwin 后 ， 我 们 可 以 通过 其 命令 行进 入 任何 Windows 平台 的 任何 一 级 目录 。 





Cygwin 通过 /cygdrive 目录 来 映射 Windws 的 根 目录 。 进 入 /cygdrive 目录 ， 其 目录 中 则 对 于 
Windws 中 的 c、d 等 卷 。 然 后 就 可 以 进入 NDK 的 保存 目录 中 ， 如 E:\Android\tools\android- 
ndk-r7 目录 。 该 运行 过 程 如 下 : 


.384 


第 9 章 Android NDK 开发 











01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
i 


其 中 ， 


02~ 
D、 EF 
09 一 
(2 


Owner@lenovo-e536a9ef ~ 
$ cd /cygdrive/ 


Owner@lenovo-e536a9ef /cygdrive 
$ ls -a 
od a £ 


Owner@lenovo-e536a9ef /cygdrive 
$ cd e/Android/tools/android-ndk-r7/ 


Owner@lenovo-e536a9ef /cygdrive/e/Android/tools/android-ndk-r7 


01 行 ， 这 样 的 格式 为 用 户 名 和 当前 所 在 目录 ; 

06 行 ， 进 入 /cygdrive 目录 ， 该 目录 下 的 所 有 文件 便 是 映射 Windws 系统 中 的 C、 
盘 ; 

11 行 ， 进 入 Windows 系统 中 保存 NDK 的 目录 。 

选择 示例 项 目 hello-jni 


我 们 选择 编译 NDK 自 带 的 例子 hello-jni 来 进行 编译 。 在 NDK 目录 中 ， 我 们 可 以 进入 
samples 目录 中 ， 可 以 发 现 有 很 多 的 示例 项 目 。 我 们 需要 学 习 NDK 编程 ， 这 些 示 例 都 是 非 
常 好 的 入 门 学 习 资料 。 

输入 命令 cd hello-jni， 进 入 到 hello-jni 示例 的 目录 中 ， 运 行 过 程 如 下 : 





01 Owner@lenovo-e536a9ef /cygdrive/e/Android/tools/android-ndk-r7 

02 $ cd samples/ 

03 

04 Owner@lenovo-e536a9ef /cygdrive/e/Android/tools/android-ndk-r7/ 
samples 

050% $13. =a 

06 hello-gl2 module-exports native-media test-libstdc++ 

07 hello-jni native-activity native-plasma two-libs 

08 jen hello-neon native-audio san-angeles 

09 

10 Owner@lenovo-e536a9ef /cygdrive/e/Android/tools/android-ndk-r7/ 
samples 

11 $ cd hello-jni/ 

12 

13 Owner@lenovo-e536a9ef /cygdrive/e/Android/tools/android-ndk-r7/ 
samples/hello-jni 

其 中 ，02 行 ， 进 入 samples 目录 ; 

05 一 08 行 ， 显 示 samples 目录 中 的 所 有 文件 。 可 以 看 出 一 共有 12 个 文件 目录 , 这些 都 

是 不 同 的 NDK 官方 示例 。 后 面 章节 ， 我 们 将 介绍 主要 示例 实现 的 内 容 ， 
11 一 13 行 ， 进 入 需要 编译 的 hello-jni 示例 。 
(3) 编译 hello-jni 项 目 so 文件 


在 hello-jni 目录 中 ， 和 输入 ../../ndk-build， 使 用 ndk-build 对 项 目 中 的 C 代码 进行 编译 。 





第 一 次 编译 时 ， 一 般 会 发 生 错误 ， 提 示 Android NDK: Host 'awk' tool is outdated， 运 行 
过 程 如 下 : 
$ ../../ndk-build 


E:\Android\tools\android-ndk-r7\prebuilt\windows\bin\awk.exe: can't open 
file /cygdrive/e/Android/tools/android-ndk-r7/build/awk/check-awk .awk 


sou 


rce line number 1 source file /cygdrive/e/Android/tools/android-ndk-r7/ 


“Ss 
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build/awk/check-awk -awk 
Context is 
A 


Android NDK: Host 'awk' tool is outdated. Please define HOST AWK to point 
to Gawk or Nawk ! 


/cygdrive/e/Android/tools/android-ndk-r7/build/core/init.mk:258: 
Android NDK: Aborting. Sion 


这 是 由 于 NDK 自 带 的 awk 过 期 不 可 用 。 根 据 提示 找到 NDK 目录 下 的 \prebuiltwwindows\ 
bin\awk.exe, 删除 该 awk。 重 新 输入 ndk-build, 成 功 运 行 会 生成 so 文件 并 保存 到 libs/armeabi/ 
目录 中 ， 运 行 如 下 : 


Owner@lenovo-e536a9ef 


/cygdrive/e/Android/tools/android-ndk-r7/samples/hello-jni 
$ ../../ndk-build 


Gdbserver : [arm-linux-androideabi-4.4.3] libs/armeabi/gdbserver 
Gdbsetup : libs/armeabi/gdb.setup 


Install : libhello-jni.so => libs/armeabi/libhello-jni.so 


编译 执行 成 功 后 , 它 会 自动 生成 一 个 libs 目录 , 把 编译 生成 的 so 文件 放 在 里 面 。 这样， 
我 们 就 可 以 编译 出 so 文件 。 接 下 来 ， 我 们 验证 该 so 文件 是 否 编译 正确 并 可 以 使 用 。 

(4) 使 用 so 文件 

对 于 NDK 中 的 自 带 例子 是 无 法 直接 导入 到 Eclipse 开发 环境 中 的 ,需要 新 建 工 程 来 间 
接 实现 NDK 项 目的 导入 。 具 体 的 方法 如 下 : 

在 Eclipse 中 新 建 一 个 工程 HelloJni。 需 要 注意 的 是 ， 新 建 的 工程 需要 选择 通过 Create 
project from existing source 方法 建立 起 hello-jni 项 目 , 项 目的 位 置 选择 示例 工程 所 在 的 位 置 
并 且 在 选择 API level 时 需要 选择 1.5 或 更 高 的 版 本 ， 如 图 9.11 所 示 。 


create Android Project 
Select project name and type of project 


Project Wune: HelloJni] 


OCraste nav project in workspace 


ect Eron existing sunple 








口 Aaa project to working sets 








[CBeex J get> 








图 9.11 新 建 项 目 


通过 这 样 的 方式 ， 成 功 导入 项 目 后 ， 其 目录 如 图 9.12 所 示 ， 可 以 看 到 在 其 jni 目录 中 
有 C 文件 和 make 文件 ;在 其 libs 目录 中 有 刚才 编译 生成 的 so 文件 。 
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在 模拟 器 中 运行 导入 的 示例 项 目 , 我们 可 以 在 模拟 器 中 看 到 Hello from JNI,， 如 图 9.13 
所 示 。 


以 














ellojni 
局 Paskage 2 各 Jierarch| 呈 日 
站 气 
Esler | 
由 固 sre 
HS een [Generated Java Files] 
由 2 Mndroid 1.5 
EB assets 
由 证 bin 
FB jni 
ndroid nk 
C) hello-jni.e 
elibs 
5 BG ameabi 
gdb, setup 
dbserver 
WG obj 
HD res 
HG tests 


Androi dManifest, xnl 
目 default. properties 
WL 


project. properties 





图 9.12 成 功 导 入 目录 图 9.13 示例 项 目 运 行 成 功 
通过 这 样 的 步骤 ， 我 们 实现 了 最 基本 的 NDK 开发 环境 的 搭建 。 但 是 ， 这 样 和 我 们 习 
惯 使 用 的 Eclipse 开发 平台 不 能 直接 连接 使 用 ， 不 利于 高 效 的 开发 。 接 下 来 ， 我 们 实现 与 
Eclipse 的 连接 。 





9.1.4 安装 Eclipse 下 C/C++ 开发 工具 


为 了 在 Eclipse 中 进行 C/C++ 的 直接 开发 ， 需 要 安装 其 开发 插件 CDT。 安 装 步 又 如 下 : 
1. 插件 地 址 


首先 登录 http://www.eclipse.org/cdt/downloads.php, 找到 对 应 你 Eclipse 版 本 的 CDT 插 
件 的 在 线 安装 地 址 ， 对 于 最 新 版 本 的 Indigo， 如 图 9.14 所 示 。 
CDT 3.0.1 for Eclipse Indigo 
Eclipse package: Eclipse CiC++ IDE Indigo SR-1 
p2 software repository: http:/download.eclipse.org/toolsicdtreleasesiindigo 
The git repos have beentagged with the CDT_8_0_1 tag. You can download the source from the web interface 


Archived p2 repos: 


ma Cdt-master-8.0.1.zip 


a Ct-master-8.0.0.zip 


图 9.14 CDT 插件 安装 


ws 
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如 图 9.14 所 示 。 最 上 方 是 一 个 Eclipse C/C++ IDE Indigo SR-1 的 下 载 链接 ， 该 链接 是 
用 于 下 载 自 带 集成 了 CDT 插件 的 Eclipse 开发 环境 ， 如 果 当 前 计算 机 上 没有 安装 任 一 版 本 
的 Eclipse， 则 可 以 选择 下 载 安 装 此 版 本 Eclipse， 则 无 需 再 另外 安装 CDT。 

如 果 已 经 安装 了 Eclipse Indigo， 则 可 以 使 用 第 二 个 连接 p2 software repository 的 地 址 。 


2. 在 线 安 装 
在 Eclipse 的 Help 菜单 下 选择 Install New Software 命令 。 在 弹出 对 话 框 的 work with 


框 中 ， 输 入 上 述 的 链接 地 址 。 当 显示 插件 列表 后 ， 选 择 Select All 选项 ， 然 后 单 击 Next 按 
钮 即 可 完成 安装 ， 如 图 9.15 所 示 。 


Available Software 
Check the itens that yor wish to install， 











ork with: [http://dornloud. eclipse. erttosls/eatrealeasex/ealilte 日 mn 
Find more software by working with the ‘Available Software Sites’ prefsrences, 














Version 
© OO cr in Pestwes 
回电 Belipse C/CH+ Develoyment 7 6.0.2.201002161416 
[a Eelipse C/Ctt Developnent T 6.0.2.201002161416 
BS OU COT 0ptional Peatures 
OW CT Debugeer Services Ere 2.0.0.201002161416 
OP cr Ge Cross Conpiler Supp 1.0.0.201002161416 
2 cor oy Toolehsin Build Sup, 6.0.0.201002161416 
OR Cor oN Toslehain Debug Sug 6.0.0.201002161416 
BO cor Wilitins 5.4.0.201002161416 
外 Eelipse CACH Developaent F. 6.0.2.201002161416 





Datsils 一 
GOB DS Dibuggar Integration 


Shon only the latest versions of available software Dide itens that are lreudy installed 
roup itons by category What is Slready instaled? 
ontact all update sites during install to find requ.red softrare 


@ 区 





图 9.15 ”CDT 插件 列表 


当然 , 也 可 以 不 安装 所 有 的 组 件 , 那么 则 需要 勾 选 CDT Main Features 分 类 并 勾 选 CDT 
Optional Features 下 的 C/C++ Development Platform、 C/C++ DSF GDB Debugger Integration、 
C/C++ GCC Cross Compiler Support、 C/C++ GNU Toolchain Build Support、 C/C++ GNU 
Toolchain Debug Support、 Eclipse Debugger for C/C++、Miscellaneous C/C++ Utilities 这 些 组 
件 ， 其 他 组 件 可 以 在 需要 用 的 时 候 再 进行 安装 。 

如 果 在 线 安装 的 方法 由 于 网 络 原因 或 者 其 他 原因 不 能 够 成 功 完成 ， 则 可 以 通过 下 载 离 
线 安 装 包 的 方式 进行 安装 。 首 先 需要 通过 如 图 9.14 中 最 下 方 的 链接 下 载 CDT 安装 包 ， 例 
如 目前 最 新 的 8.0.1 版 本 ， 下 载 到 本 地 后 ， 在 如 图 9.15 所 示 的 对 话 框 中 单 击 地 址 栏 右 方 的 
Add... 按 钮 ， 然 后 单 击 Archive 按钮 定位 到 刚 下 载 的 cdt-master-8.0.1.zip 压缩 包 ， 再 进行 安 
装 即 可 。 
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3. 验证 CDT 安 装 成 功 


在 Eclipse 中 新 建 一 个 项 目 , 如 果 出 现 了 C/C++ 项 目 , 则 表明 你 的 CDT 插件 安装 成 功 ， 
如 图 9.16 所 示 。 














1 File from Tenplate 
CH Folder 

NY Header File 

上 Source File 














图 9.16 ”CDT 安装 成 功 


如 图 9.16 所 示 , 对 于 现 有 的 Java 或 Android 项目 可 以 通过 列表 下 的 第 四 个 选项 Convert 
to a C/C++ Project (Add C/C++ Nature) 来 为 项 目 添加 C/C++ 相关 支持 。 


9.1.5 安装 Eclipse 下 Sequoyah 插件 


通过 安装 CDT 插件 ， 我 们 便 可 以 在 Eclipse 中 进行 C/C++ 的 开发 ， 但 是 针对 Android 
的 NDK 开发 不 够 方便 ,我 们 需要 安装 Sequoyah 插件 来 帮助 我 们 生成 mk 文件 ,利用 cygwin 
环境 自动 编译 生成 so 文件 等 。 

1. 在 线 安装 插件 


Sequoyah 插件 的 官方 下 载 地 址 为 http://www.eclipse.org/sequoyah/downloads/， 在 该 网 
页 上 找到 Eclipse 对 应 版 本 用 于 在 线 安装 的 update site 地 址 以 及 安装 包 的 下 载 地 址 。 和 在 线 
安装 CDT 插件 一 样 , 在 Eclipse 的 Help 菜单 下 选择 Install New Software 命令 , 在 弹出 对 话 
框 的 work with 框 中 ， 输 入 该 地 址 。 

需要 注意 的 是 , 在 安装 界面 要 确认 Group items by category 复 选 框 处 于 未 选中 状态 , 否 
则 可 能 出 现 列表 为 空 (There are no categorized items) 的 情况 。 全 部 勾 选 列 出 的 安装 包 并 完 
成 安装 ， 如 图 9.17 所 示 。 
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ER CC Ea ht] 


Find more software by working with the “Available Softrare Sites” preferences, 




















Wersien 








[EEC [ea items selected 


Details 





回 Shew only the latest versions of availsble software Difide itens that are slready installed 
What is already installed? 

DShow only software spplicable to terget enviromment 

回 Contast dl update sites during install to find required software 





@ 





图 9.17 在 线 安装 Sequoyah 


2. 添加 NDK 路 径 


当 安装 成 功 后 ， 需 要 设置 NDK 的 路 径 。 在 Eclipse 的 Window 菜单 中 选择 Preferences 
命令 ， 在 弹出 对 话 框 中 选择 Android|“ 本 机 开发 ”选项 ， 如 图 9.18 所 示 。 在 本 机 开发 中 ， 


选择 NDK 的 保存 路 径 。 








图 9.18 添加 NDK 路径 
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3. 添加 原生 开发 支持 


鼠标 右键 单 击 任意 的 Android Project， 会 发 现在 弹出 菜单 的 Android Tools 中 多 出 了 一 
个 Add Native Support... 选 项， 如 图 9.19 所 示 。 


Source 各 t+Shi ft+S 上 
Refactor 各 t+ShiEttT » 
Fr J Vee Test Project 
Export. Ber Resource File 
hfeh 3 Export Signed Application Package . 
Close Project Export lnsigned Application Package. I 





Bhssign Working Sets.. 


回 Bun Lint: Check for Conmon Errors 
Clear Lint Warkers 





图 9.19 原生 开发 支持 


单 击 后 会 弹出 一 个 简单 的 设置 界面 ， 如 图 9.20 所 示 。 在 “项 目 ” 栏 里 选择 需要 添加 本 
地 支持 的 项 目 名 称 。 在 “将 添加 库 名 称 lib*.so” 一 栏 中 ， 填 写 需 要 生成 库 的 名 称 。 例 如 ， 
对 于 helloJni 项 目的 库 名 称 即 为 libhellojni.so， 在 此 处 填写 helloJni 即 可 。 


PE 























图 9.20 设置 本 机 支持 


通过 下 载 NDK 开发 包 、 安 装 Cygwin 软件 以 及 相关 编译 工具 、 安 装 CDT、 安 装 Sequoyah 
插件 这 些 步骤 ， 我 们 完成 了 Windows 平台 下 Eclipse 中 开发 Android NDK 的 环境 搭建 。 接 
下 来 ， 我 们 就 来 实现 最 简单 的 NDK 程序 。 


9.2 计 算 器 


通过 上 一 节 的 介绍 ,我 们 实现 了 在 Windows 平 台 下 的 NDK 环境 的 搭建 ,并 且 通 过 NDK 
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示例 代码 验证 了 平台 的 成 功 搭建 。 接 下 来 ， 我 们 通过 实现 一 个 简易 的 计算 器 来 讲解 最 基本 
的 NDK 开发 流程 和 需要 注意 的 关键 点 。 


9.2.1 界面 开发 


6 


虽然 Android 从 1.5 版 本 之 后 支持 了 NDK 的 原生 开发 ， 可 以 使 用 C/C++ 来 进行 开发 。 
但 是 , 这 些 NDK 的 开发 都 是 作为 应 用 程序 依赖 的 一 个 库 来 进行 调用 的 ， 所 以 在 与 Android 
界面 相关 的 布局 、 用 户 交 互 处 理 等 都 是 和 前 面 的 章节 一 样 ， 需 要 通过 Java 来 实现 。 

首先 ， 新 建 一 个 Android 项 目 。 其 过 程 和 新 建 一 般 的 Android 项 目 步骤 是 一 样 的 ， 只 
是 需要 注意 的 是 对 SDK 版 本 的 选择 。 由 于 NDK 是 在 Android 1.5 版 本 之 后 才 进 行 支持 的 ， 
因此 选择 1.5 版 本 以 上 的 SDK。 

由 于 在 界面 布局 中 , 我 们 不 需要 使 用 到 NDK 的 本 地 支持 , 只 需要 在 XML 布局 文件 中 
进行 描述 即 可 。 对 于 我 们 需要 实现 的 功能 ， 针 对 输入 的 两 个 数 进行 加 、 减 、 乘 、 除 这 4 种 
对 基本 的 四 则 运算 。 在 界面 中 ， 我 们 只 需要 两 个 数 的 输入 框 、 一 个 进行 四 则 运算 的 按钮 以 
及 一 个 运算 结果 输出 框 即 可 ， 如 图 9.21 所 示 。 





9.2.2 NDK 本 地 支持 


1. 添加 本 地 支持 

我 们 在 功能 实现 时 ， 将 需要 进行 的 加 减 乘除 四 则 运算 使 用 C 语言 来 实现 ， 所 以 在 工程 
中 需要 本 地 支持 。 使 用 Sequoyah 插件 提供 的 支持 功能 ， 实 现 如 下 : 在 新 建 的 项 目 中 ， 鼠 标 
右键 单 击 ， 在 Android Tools 中 选择 Add Native Support...， 如 图 9.19 所 示 。 在 弹出 对 话 框 
中 ， 一 般 保持 默认 情况 即 可 ， 如 图 9.22 所 示 。 其 中 ， 弹 出 对 话 框 中 可 以 选择 需要 本 地 支持 
的 项 目 、 显 示 已 经 设置 好 的 NDK 位 置 以 及 生成 的 so 文件 名 称 。 


jnicaleulator 
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项 目 
用 于 向 项 目 添加 本 机 支持 的 设置 


项 目 


请 输入 数字 
edssoneeE 项 目 JniCaleulator 
进行 四 则 运算 = 


320k 位 置 
Endroid\tools\android-ndlerT 


将 添加 库 名 称 libs so 
Taicalealater 























图 9.21 计算 器 界面 图 9.22 添加 本 地 支持 
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单 击 Finish 按钮 完成 后 , 切换 到 Android 本 地 支持 视图 界面 。 项 目的 结构 将 发 生变 化 ， 
变 成 如 图 9.23 所 示 。 可 以 看 到 多 了 一 个 名 为 jni 的 目录 ,这 个 目录 便 是 Sequoyah 自动 生成 
的 用 于 存放 C/C++ 源 代码 的 目录 ， 该 目录 下 存在 两 个 文件 ， Android.mk 是 用 于 描述 代码 的 
编译 规则 的 ;cpp 文件 用 于 编写 C/C++ 源码 。 





日 本 Jmicaleulator 
Oe 
己 宙 com. ouling JniCalculator 
[DD JaiCaleulatorhetivity java 
3 gm [Generated Jara Files] 
HB Android 2.2 





日 机 com. ouling JniCal eulat: 
HD JaiCaleulatorAetivit 
3 em [Generated Java Files] 
由 呈 Android 2.2 








忆 assets 
Bbin 
岂 res 
加 Mndroi Manifest, xnl 
proguard cfg 加 Andiroi 明 anifest. xml 
国 projeet. properties 了 progaard cfg 
国 project. properties 
(a) 添加 前 的 目录 (b) 添加 后 的 目录 
图 9.23 项 目 结构 变化 
2. Android.mk 
Android.mk 是 用 于 描述 代码 的 编译 规则 的 ， 相 当 于 makefile。 虽 然 ， 我 们 可 以 使 用 插 


件 对 编译 的 规则 进行 自 带 生成 , 但 是 我 们 需要 明白 Android.mk 描述 的 规则 涵义 。 每 个 编译 
模块 都 是 以 include $(CLEAR_VARS) 开 始 ， 以 include $S(BUILD_XXX) 结 束 。 在 本 示例 中 ， 
描述 的 内 容 如 下 : 


01 LOCAL PATH := $(call my-dir) 
02 include $(CLEAR VARS) 


03 LOCAL MODULE := JniCalculator 
04 ### Add all source file names to be included in lib separated by a 
whitespace 

05 LOCAL SRC FILES := JniCalculator.cpp 

06 include $(BUILD SHARED LIBRARY) 

其 中 ，01 行 的 内 容 是 对 LOCAL PATH 变量 进行 赋值 。 每 个 Android.mk 文件 都 必须 
以 此 操作 为 第 一 句 , 该 语句 的 作用 是 为 了 能 够 在 项 目的 目录 树 中 定位 源 代码 文件 ， NDK 的 
编译 系统 根据 这 个 变量 来 寻找 所 需 的 源 代码 文件 。 在 此 处 使 用 到 了 由 NDK 编译 器 所 提供 
的 一 个 宏 函 数 my-dir， 它 能 够 返回 当前 目录 ， 在 此 处 即 是 包含 C++ 代码 的 jni 目录 ; 

02 行 include $S(CLEAR VARS)， 其 中 的 CLEAR_VARS 变量 是 由 NDK 编译 提供 的 变 
量 ， 该 变量 指向 了 一 个 特定 的 GNU Makefile 。 这 个 Makefile 的 作用 是 重 置 所 有 除 
LOCAL PATH 外 的 其 他 所 有 形 如 LOCAL XXX 形式 的 变量 ， 由 于 所 有 控制 编译 的 文件 都 
是 在 一 个 唯一 的 GNU Make 执行 环境 中 进行 解析 的 ,因此 必须 在 开始 新 的 编译 前 正确 地 处 
理 所 有 的 全 局 变量 ; 

03 行 LOCAL MODULE := JniCalculator，LOCAL MODULE 变量 是 用 于 指定 所 有 需 
要 编译 的 模板 ， 因 此 这 一 行 也 是 必须 具备 的 ， 这 个 变量 的 值 必 须 是 唯一 的 且 不 包含 空格 字 
符 。NDK 在 生成 模块 时 会 自动 地 为 该 变量 值 添加 前 绥 lib 和 后 缀 so， 因 此 在 本 例 中 将 生成 
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名 为 libJniCalculator so 的 模块 ， 这 个 模块 将 在 Java 代码 中 用 于 加 载 模块 的 操作 , 在 后 文中 
将 会 看 到 ; 

05 行 LOCAL SRC FILES := JniCalculator.cpp; 这 一 行 相对 简单 , LOCAL SRC FILES 
即 用 于 指定 源 代码 文件 的 变量 。 本 例 中 只 存在 由 Sequoyah 生成 一 个 源 文件 
JniCalculator.cpp， 如 果 存 在 多 个 源 文件 ， 则 在 多 个 文件 名 中 用 空格 分 开 。 在 列 出 源 文件 时 
不 需要 把 头 文件 或 者 included 的 文件 列 出 来 ， 因 为 编译 器 会 自动 加 载 这 些 依赖 项 ， 仅 仅 列 
出 源 文件 即 可 ; 

06 行 include$ (BUILD SHARED LIBRARY) ，BUILD SHARED LIBRARY 也 是 由 
编译 器 提供 的 指向 一 个 GNU Makefile 文件 的 变量 ， 该 Makefile 的 作用 是 搜集 所 有 的 从 最 
近 一 个 include $ (CLEAR VARS) 语 句 之 后 的 所 有 LOCAL XXX 形式 的 变量 信息 ， 从 而 分 
析 得 出 应 该 如 何 来 进行 编译 并 完成 相应 的 编译 构建 工作 。 与 此 相关 的 还 有 
BUILD_STATIC_LIBRARY 变量 用 于 构建 一 个 静态 的 库 , 两 则 的 区 别 是 ,只 有 shared library 
会 被 复制 到 应 用 程序 的 安装 包 ， 而 static library 也 可 用 于 生成 shared library。 


3. cpp 文 件 











自动 生成 的 cpp 文件 则 是 C++ 源 代码 文件 ， 这 个 默认 的 文件 是 空 的 ， 只 包含 了 两 个 
include 语句 ， 如 下 : 

#include <string.h> 

#include <jni.h> 

在 jnih 文件 中 , 定义 了 本 地 的 数据 类 型 和 对 象 的 引用 类 型 。 在 cpp 文件 中 编写 C 代码 
时 ， 需 要 注意 的 是 ， 必 须 使 用 这 些 定 义 的 本 地 数据 类 型 和 对 象 引用 类 型 。 

对 于 数据 类 型 ， 一 般 都 是 在 Java 对 应 类 型 前 添加 一 个 j， 有 具体 对 应 关系 如 表 9-1 所 示 。 


表 9-1 Java 类 型 与 本 地 类 型 的 对 应 关系 














Java 类 型 说 上 明 
boolean 无 符号 ，8 位 
byte 无 符号 ，8 位 
char 无 符号 ，16 位 
short jshort 无 符号 ，16 位 
int jint 无 符号 ，32 位 
long jlong 无 符号 ，64 位 
float jfloat 32 位 
double jdouble 64 位 








Void void N/A 


JNI 包含 了 很 多 对 应 于 不 同 Java 对 象 的 引用 类 型 ， 这 些 引用 类 型 的 组 织 层次 如 图 9.24 
所 示 。 
接 下 来 , 我 们 在 cpp 文件 中 实现 两 个 数 的 相 加 功能 。 需 要 特别 注意 JNI 调用 的 两 点 规则 。 
CL oxen" 
于 NDK 主要 是 配合 C 语言 开发 , 但 是 Sequoyah 插件 帮 我 们 生成 的 是 cpp 文件 。 在 
默认 情况 下 , 会 使 用 C++ 的 编译 方式 来 进行 编译 ,这样 会 导致 在 Java 调用 时 无 法 找到 对 应 
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的 函数 接口 。 因 此 前 面 一 段 添加 了 extem "C" 关 键 字 , 用 于 告诉 编译 器 其 内 部 包含 的 函数 是 
使 用 C 语言 编写 的 。 


JR 所 有 Java 对 象 
SS java.lang.Class 对 象 
Je java.lang.String 对 象 
jaray-------------------- 数组 

jobjectAmray. ---------- object 数组 

jbooleanAraY -~-------. boolean 数组 

AR byte 数组 

jcharArray ----------- char 数组 

jshortArray _________.. short 数组 

| ==E========= int 数 组 

jongAmmy == long 数组 

jfloatArmray ----------- float 数组 

jdoubleAray- --------- double 数组 
Re java.lang.Throwable 对 象 


图 9.24 JNI 对 Java 对 象 的 引用 类 型 


(2) 函数 定义 规则 

在 编写 函数 时 ， 对 于 其 函数 名 必须 符合 规则 ， 不 然 JNI 调用 时 无 法 找到 需要 的 函数 。 
其 函数 定义 如 下 : 

JNIEXPORT <JNI type> JNICALL Java <package path> <class name> <method 

name> (JNIEnv *env, jobject obj, <parameter list>) 

其 中 ,函数 名 的 命名 必须 是 “JAVA_ 调 用 该 函数 的 JAVA 类 名 (完整 路 径 区 分 大 小 写 ) 
_ 函 数 名 ”。 对 于 完整 的 包 名 中 的 “.” 以 下 划 线 “ ”来 代替 。 当 package path 和 class name 
中 如 果 出 现 “_” 字 符 ， 用“_1” 代替 ， 出 现 er ， 用 “_ 2” 代替 。 例 如 ， 本 例 中 的 加 法 
函数 命名 为 下 : 


Java com ouling JniCalculator JniCalculatorActivity add 


即 该 方法 对 应 在 Java 代码 的 com.ouling.JniCalculator 包 内 的 JniCalculatorActivity 类 中 
声明 的 ， 方 法 名 称 为 add。 

对 于 函数 的 参数 定义 JNIEnv *env, jobject obj,， 两 个 参数 是 必需 的 , 之 后 才 是 在 函数 调用 
时 需要 传递 的 参数 。 在 本 例 中 ， 加 法 函数 需要 传递 两 个 进行 相 加 的 数 ， 其 完整 的 定义 如 下 : 

JNIEXPORT jint JNICALL Java com ouling JniCalculator JniCalculator 

Activity add( 

JUNIEnv *env, jobject obj, jint valuel, jint value2); 

即 表明 导出 了 一 个 JNI 调用 的 方法 。 有 两 个 参数 ， 都 为 jint 本 地 类 型 ， 返 回 值 为 jint 

的 本 地 类 型 。 掌 握 了 这 些 函数 定义 关键 点 ， 本 例 中 加 法 函数 的 具体 实现 如 下 : 


01 extern "C" { 
02 JNIEXPORT jint JNICALL Java com ouling JniCalculator JniCalculator 
Activi ty add ‘tf 
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03 JUNIEnv *env, jobject obj, jint valuel, jint value2) 

04 1}; 

05 

06 JjJint JNICALL Java com ouling JniCalculator JniCalculatorActivity add( 
07 UNIEnv *env, jobject obj, jint valuel, jint value2) { 

08 return (valuel + value2); 

09 3} 


其 中 ，01 行 ， 用 于 告诉 编译 器 其 内 部 包含 的 函数 使 用 C 语言 编写 ， 使 用 C 的 编译 
方式 ; 

02 一 03 行 ， 标 准 的 JNI 调用 函数 定义 ; 

06 一 09 行 ， 实 现 定义 JINI 调用 函数 。 

4. 添加 依赖 包 


进行 了 代码 的 添加 与 保存 后 ,可 能 会 发 现 Eclipse 进行 了 报错 , 提示 找 不 到 与 JNI 相关 
的 一 些 定义 ， 如 图 9.25 所 示 。 


时 1#include REipge| 





网 4JNIEXPORT jint JNICALL Java_ com ouling JniCalculator JniCalculatorActivity addll 
赣 5 INIEnv *env，]j9blec5 obhj, jint valuel, jint value2); 

网 6 JNIEXPORT jinc JNICALL Java com ouling JniCalculator JniCalculatorActivity min( 
六? JIEnY * env, jobiect oh}, Jint valuel, jin value2) 7 

9 JNIEXPORT jint JNICALL Java com ouling JniCalculator JniCaloulatorActivity mul( 
寂 9 INIEnY * env, jobiect obj, dint valuel, jint value2); 

M10 JNIEXPORT Jint JNICALL Java com ouling JniCalculator JniCaloulatorActivity divi, 
ell INIEnY * env, Joblect obj, Jint valuel, Aint value2); 
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图 9.25 未 添加 依赖 包 错误 


这 时 需要 修改 项 目的 属性 ， 添 加 依赖 包 。 在 项 目的 右键 菜单 中 选择 Properties， 弹 出 如 
图 9.26 所 示 的 界面 。 单 击 C/C++ GernerallPaths and Symbols|Imcludes|GNU C 选项 ， 然 后 单 
击 Add.. .按钮 。 在 弹出 对 话 框 中 单 击 File system 按钮 , 添加 <ndk>\platforms\android-8\arch- 
armvusrinclude， 添 加 完成 后 ， 需 要 重新 Build 项 目 ， 即 可 解决 。 
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图 9.26 添加 ndk 依赖 包 
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9.2.3 ”调用 实现 


1. 调用 声明 


在 Java 代码 中 ， 对 C 语言 编写 的 方法 进行 调用 。 需 要 加 载 编译 好 的 so 文件 库 ， 并 且 
声明 该 调用 方法 为 原生 的 方法 。 例 如 : 


01 Static 

02 { 

03 System.1loadLibrary ("JniCalculator"); // 加 载 库 

04 } 

05 // 将 两 个 整数 相 加 ， 返 回 它 们 的 和 
06 public native int add( int x，int y ); // 定 义 原生 方法 


其 中 , 01 行 , 使 用 Java 的 static 关键 字 , 表明 其 内 部 的 代码 需要 在 类 初始 化 时 便 执行 ; 

03 行 ， 加 载 JniCalculator 库 。 需 要 注意 的 是 加 载 的 库 名 即 编译 生成 的 库 名 ， 去 掉 前 级 
lib 和 后 绥 so; 

06 行 ， 声 明 原 生 方 法 。 需 要 注意 的 是 必须 加 上 关键 字 native， 表 明 该 方法 是 原生 方法 。 

在 具体 Java 代码 调用 时 ， 和 调用 Java 的 其 他 方法 一 样 ， 直 接 调用 就 可 以 了 。 例 如 在 
本 例 中 ， 单 击 后 调用 加 法 方法 实现 相 加 ， 具 体 实现 如 下 : 


01 btn cal.setOnClickListener (new OnClickListener() { 
02 Q@Override 


03 public void onClick(View v) { 

04 String numStringl=edt numl .getText() .tostring(); // 获 取 输 入 数据 1 

05 String numString2=edt_num2 .getText() .toString () ;// 获 取 输 入 数据 2 

06 int numl=Integer.valueOf (numString1l) 

07 int num2=Integer.valueOf (numString2) 

08 int num= add(numl, num2); // 调 用 NDK 方法 相 加 

09 StringBuilder sbBuilder=new StringBuilder(); 

10 sbBuilder.append (numStringl+" 十 "+numString2+" = "+String. 
valueOf (num) +"\n"); 

i tv result .setText (sbBuilder.toString()); // 结 果 显 示 

43 } 

La 


其 中 ，08 行 ， 调 用 add 方法 。 从 代码 中 很 明显 地 看 出 ， 与 直接 使 用 Java 的 方法 一 样 。 
2. 编译 设置 


在 Eclipse 中 我 们 一 直 保 持 自动 生成 的 选项 ， 当 我 们 修改 文件 时 ，Eclipse 将 自动 编译 
生成 一 次 代码 。 但 是 ， 当 我 们 进行 NDK 编译 的 时 候 会 使 用 到 交叉 编译 ， 耗 时 比较 长 。 
此 ， 单 击 Eclipse 的 Project 选项 ， 取 消 掉 Build Automatically。 

在 进行 编译 之 前 ， 我 们 需要 设置 好 so 文件 的 交叉 编译 环境 。 在 前 一 小 节 中 验证 NDK 
的 环境 时 ,我 们 是 在 Cygwin 模拟 的 Linux 环境 中 使 用 ndk-build 来 进行 编译 的 .在 Windows 
平台 中 ， 我 们 需要 进行 如 下 配置 才能 直接 使 用 Eclipse 来 进行 编译 。 

(1) bash 设置 

于 以 bash 命令 运行 ndk-build 等 效 于 在 Unix 环境 下 运行 ndk-build， 所 以 我 们 在 
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Windows 环境 变量 里 加 入 bash 所 在 目录 ， 即 Cygwin 的 bin 目录 。 

在 Windows XP 中 添加 环境 变量 的 方法 如 下 : 鼠标 右键 单 击 “ 我 的 电脑 ”|“ 属 性 ”| 
“高 级 ”|“ 环 境 变量 ”命令 。 在 对 话 框 中 选择 系统 环境 变量 中 的 Path， 编 辑 该 值 。 在 其 最 
后 添加 Cygwin 的 bin 目录， 如 Ei\cygwin\bin， 如 图 9.27 所 示 。 








ED | 
[天 _Ti 划 机 名 | 齐 作 “| 高大。 | 系统 示 原 | 自动 更 新 远程 | 





[Erm 加 本 


Tai 
\MySQL Sekver 5.1\bin:E:\cyerin\bin 

















图 9.27 添加 Windows 环境 变量 


(2) ndk-build 设置 

由 于 ndk-build 只 能 够 在 Unix 环境 下 执行 ,而 当前 系统 环境 是 Windows， Build 的 默认 
设置 可 能 是 直接 运行 ndk-build 而 导致 错误 。 

在 项 目 属性 中 进行 设置 。 鼠 标 右键 单 击 项 目 选 择 Properties 命令 ， 弹 出 界面 如 图 9.28 
所 示 。 选 择 C/C++ Build， 在 Builder Settings 选项 卡 中 ， 取 消 Use default build command 选 
项 ， 并 在 Build Command 中 填 入 : bash <ndk>mdk-build， 其 中 的 <ndk> 需 要 替换 为 安装 ndk 
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图 9.28 ”ndk-build 设置 
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(3) 手动 构建 生成 项 目 














通过 以 上 两 步 ， 我 们 就 可 以 手动 构建 生成 项 目 了 。 当 我 们 需要 编译 生成 项 目 时 ， 用 鼠 
标 右键 单 击 项 目 选择 Build Project 命令 对 项 目 进行 构建 并 生成 应 用 程序 ， 如 图 9.29 所 示 。 
ee 
hs | 硬 cor Cte 
i ee 僵 coz euifiea ee 
EE ed 
Dinwies §) illing project... 
ib 已 
二 Baild path -和 | 
了 本 人 人 Invokine Cormend, bash Bi WandroiahtoalsvendroidrndlrTtnalrbuild Y=1 
| 上 A ert 
i prt Dl rin Doce ound 
二 FF Eee [Cessy] 








图 9.29 手动 构建 项 目 


这 一 步 需要 观察 Eclipse Console (如果 没有 该 视图 通过 单 击 Eclipse 编译 器 菜单 栏 的 
Window|Show View|Console 命令 显示 ) 的 输出 ， 当 成 功 时 其 输出 如 图 9.30 所 示 。 


桓 设 和 管理 | 国 mlstor catal 加 tu 加 aa BL frotles DT 3 
DT Build Console [JniCalculator: 
nstall : libJniCalculacor.so => libs/armeabi/1libJniCalculator.so 





mkdir -p ./libs/armeabi 
install -p ./obj/ local/armeabi/ libJniCalculator .so ./1ibs/armeabi/1ibJniCalculator.so 
/eygdr ive/e/Android/tools/android-ndk-r7/toolchains/arm-linux-androideabi-4.4.3/prebuilt/win¢ 


Ee ~-strip-unneeded [.71ib3/armeabi/ libInicalculacor.s0 | 


wert Build Finished ess 





图 9.30 成 功 生成 项 目 


如 果 Build 工具 没有 配置 正确 ， 则 可 能 输出 错误 信息 ， 如 图 9.31 所 示 。 图 9.31 (a) 表 
示 bash 设置 错误 ， 需 要 检查 Windows 环境 变量 是 否 设置 正确 ; 图 9.31 (b) 表示 ndk-build 
设置 错误 ， 需 要 检查 ndk-build 的 路 径 是 否 正确 。 





芭 Protlms| @ even Decree 





CDT Build Console [ex_call 





nar Build of configuration Default for project ex_cal ss 
bash E:\Android\tools\android-ndk-r7\ndk-build V=1 


Cannot run program "bash": Launching failed 
Error: Program "bash" is not found in PA’ 


(a) bash 设置 错误 


区 pobems| 辐 Tea 人 [加 En 3 propertes 
[CDT Build Console [TestEnv] 





“ewe Build of configuration Default for project TestEnv **** 
ndk-build V=1 
Error: Cannot run progran “ndk-build": Launching failed 


ees Build Finished **** 
(b) ndk-build 设置 错误 
图 9.31 设置 错误 信息 


3. 运行 
当 编 译 生成 成 功 后 ， 可 以 发 现 项 目 中 增加 了 Binaries， 其 中 包含 了 生成 的 库 文件 
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同时 ， 在 libs 目录 中 也 包含 了 该 库 文件 ， 如 图 9.32 所 示 。 
通过 上 面 的 步骤 ， 我 们 已 经 实现 了 两 个 数 的 相 加 ， 对 于 其 他 的 减法 、 乘 法 、 除 法 操作 


libJniCalculator so 。 


都 可 以 通过 类 似 的 方法 在 C 语言 中 实现 ， 就 不 再 
模拟 器 上 运行 该 项 目 
的 数字 ， 单 击 按钮 进行 四 则 运算 ， 结 果 如 图 9.33 所 示 。 
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Q AndroiManifest, xml 
] mL 

] proguard cfg 

四 project. properties 





次 述 。 当 实现 了 加 减 乘除 四 则 运算 后 ,在 
， 即 可 看 到 如 图 9.21 所 示 的 界面 。 在 界面 中 ， 输 入 我 们 需要 进行 计算 


图 9.32 编译 成 功 后 的 目录 图 9.33 计算 结果 
9.2.4 总 结 


在 本 节 中 我 们 通过 NDK 实现 了 对 简易 四 则 运算 的 计算 器 功能 ， 
第 一 个 NDK 应 用 程序 。 通 过 示例 的 开发 ， 我 们 
用 NDK 实现 时 ， 需 要 4 


更 重要 的 这 是 实现 了 


- 步 一 步 地 实现 了 第 一 个 NDK 应 用 : 在 使 
和 村 别 注 意 mk 文件 的 编写 、 本 地 原生 函数 的 定义 规则 以 及 编译 环境 的 


配置 ， 在 Java 调用 时 ， 需 要 注意 首先 调用 系统 加 载 实现 的 so 文件 库 以 及 原生 方法 关键 字 
等 。 同 时 我 们 明白 了 Android 应 用 程序 的 基本 框架 始终 是 用 Java 来 实现 ， 而 对 于 需要 其 调 


用 的 方法 可 以 使 用 C 语言 来 实现 。 


9.3 等 离子 图 像 效 果 


在 上 一 小 节 中 已 经 实现 了 一 个 NDK 入 门 示 例 ， 示 例 通过 调用 本 地 方法 实现 加 减 乘除 
则 运算 , 功能 比较 简单 , 本 小 节 将 通过 解析 NDK samples 中 的 plasma 示例 来 加 深 对 NDK 














使 用 方法 的 理解 。Plasma (等 离子 效果 ) 是 2D 图 像 处 理 中 一 种 经 








性 变幻 的 色彩 模拟 出 一 种 类 似 于 液体 流动 的 效果 。 
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NDK 示例 


NDK 所 包含 的 samples 是 学 习 NDK 的 非常 好 的 资料 , 这 些 samples 也 随 着 NDK 的 版 
本 更 新 而 更 新 ， 或 者 增添 新 的 sample， 因 此 ， 对 这 些 代码 进行 分 析 和 理解 对 熟悉 NDK 有 
着 非常 大 的 帮助 。 目 前 NDK 所 带 的 sample 主要 包括 如 下 几 个 : 


日 


口 
口 


9.3.2 





hello-jni: 即 在 9.1.3 节 中 用 于 验证 NDK 的 开发 环境 ， 我 们 就 使 用 了 这 个 示例 。 这 

个 示例 的 功能 是 从 共享 库 中 的 一 个 native 实现 方法 装载 一 个 字符 串 ， 然 后 在 程序 

的 UI 中 显示 出 来 。 

two-libs: 顾名思义 ， 这 个 示例 涉及 了 两 个 库 。 其 中 包含 了 一 个 静态 库 和 一 个 共享 

库 , 而 native 方 法 是 在 静态 库 中 实现 的 ,共享 库 通过 引入 静态 库 的 方式 来 使 用 native 

方法 。 

san-angeles: 使 用 GLSurfaceView 对 象 管理 Activity 的 生命 周期 ， 并 使 用 native 

OpenGL ES API 着 色 3D 图 形 。 

hello-gl2: 使 用 OpenGL ES 2.0 矢量 和 fragment 阴影 对 一 个 三 角形 着 色 。 

hello-neon: 显示 如 何 使 用 cpu feature 库 来 检查 实时 CPU 兼容 性 ， 使 用 NEON 

intrinsics。 

bitmap-plasma: 演示 在 native 代码 中 如 何 处 理 Android Bitmap 对 象 的 像素 缓冲 
(pixel buffers) ， 然 后 产生 经 典 的 plasma (等 离子 ) 效果 。 

native-activity: 演示 如 何 使 用 native-app-glue 静态 库 来 实现 native activity。 

native-plasma: 使 用 native activity 的 bitmap-plasma 另 一 个 版 本 。 


建立 等 离子 效果 项 目 


由 于 NDK 所 提供 的 示例 并 不 是 直接 可 使 用 的 Eclipse 项 目 ， 因 此 需要 通过 单 击 菜单 栏 
的 NewlAndroid Project|Create project from existing source 命令 建立 项 目 ， 项 目地 址 选择 
samples 中 的 bitmap-plasma， 如 图 9.34 所 示 。 单 击 Finish 按钮 ， 即 可 得 到 新 建立 的 Plasma 
项 目 ， 项 目 目录 如 图 9.35 所 示 。 

















9 和 droi 明 ani fest.xml 
四 aefault.properties 
Sm 

“project. properties 




















图 9.34 建立 项 目 图 9.35 创建 项 目 成 功 目录 
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同样 , 之 后 需要 为 该 项 目 添 加 本 机 支持 , 才能 够 同时 进行 本 地 库 的 开发 。 使 用 Sequoyah 
插件 , 在 项 目 右键 菜单 中 选择 Android Tools|Add Native Support. .命令 。 为 了 确保 设置 的 库 
名 正确 ， 可 以 在 Plasma.java 代码 里 查看 一 下 其 loadLibrary() 方 法 的 参数 : 可 见 ， 其 库 名 称 
为 plasma， 因 此 可 在 添加 本 机 支持 时 填写 库 名 称 为 plasma， 如 图 9.36 所 示 。 









ma javs 器 ET 画 右 画 
* Copyright (c) 2010 The Androiq Ope| 
package com.example.plasma; 天 
加 本 机 支持 的 设置 
“import android.app.accivicyt 口 
public class Plasma extends hctivity | 项目 
{ 项 目 下 aas [mag] 
/rr Called when the activity ia 
Boverride OK 位 时 
public void onCreate (Bundle savedj :Vndroid\tools\miroidndrT 
{ 1t; 设置 WDK 位 置 1t: /> 


super .onCreate (saavedInstanced 
setContentView (new PlasmaVie! 
} 


将 添加 库 名 称 lib* so 


/" load our native library */ 
static { 
System. 10adLibrary (fplasma") ; 
; 
) 





2 Caeu 











图 9.36 添加 本 地 支持 


然后 用 鼠标 右键 单 击 Plasma 项 目 , 在 弹出 的 菜单 中 选择 Build Project，Bnuild 成 功 后 会 
生成 相应 的 库 ， 此 时 再 切换 到 本 地 支持 视图 下 ， 看 到 项 目的 目录 如 图 9.37 所 示 ， 已 经 有 了 
so 文件 的 保存 目录 libs。 如 果 不 能 成 功 生成 项 目 ， 依 照 上 一 小 节 的 方法 ， 检 查 本 地 依赖 库 
以 及 编译 设置 是 否 正确 。 

在 模拟 器 中 运行 该 示例 ， 效 果 如 图 9.38 所 示 ， 一 种 类 似 于 彩色 液体 流动 的 效果 。 








LE 


局 页 com. exanple plasma 
由 四 Plasma java 
由 -中 gen [Generated Java Files] 
由 Bh Android 2.2 
Bl con. android ide. eclipse. adt. LIBRARIES 
由 恋 Binaries 
由 加 Includes 
Sjini 
由 加 plasna e 
局 jadroid nk 
局 ipplication mk 


Mndroi Manifest. xnl 
aefault. properties 
3 UL 


四 project. properties 


图 9.37 生成 成 功 目录 图 9.38 运行 效果 
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9.3.3 Java 实现 


从 运行 效果 中 看 到 Plasma 效果 ， 形 成 这 种 效果 的 原理 其 实 就 是 bitmap 图 像 中 的 每 一 


个 像素 点 按照 一 点 的 规则 连续 地 变化 颜色 。 





制 Plasma 特效 。 实 现 的 关键 代码 如 下 : 
01 // 加 载 so 文件 库 


在 Java 代码 中 需要 实现 so 文件 库 的 加 载 ， 以 及 基本 的 图 像 绘 制 和 调用 本 地 方法 来 给 


02 static { 

03 System.loadLibrary ("plasma"); 

04 } 

05 

06 class PlasmaView extends View { 

07 //1ibplasma.so 本 地 方法 定义 

08 Private static native void renderPlasma (Bitmap bitmap, long time ms) 

人 

10 @Override 

El protected void onDraw (Canvas canvas) { 

h 3 renderPlasma (mBitmap, System.currentTimeMillis() - mStartTime); 
// 调 用 NDK 方 法 

13 canvas.drawBitmap (mBitmap, 0, 0, null); // 绘 制图 像 

14 invalidate(); //UI 更 新 

15 } 

16 3 


其 中 ，01 一 04 行 ， 实 现 本 地 Plasma 库 的 加 载 ; 
08 行 ， 定 义 需要 使 用 到 的 libplasma.so 中 的 本 地 方法 ; 


11 一 15 行 ， 绘 制图 像 。 实 现 Plasma 效果 的 关键 是 12 行 的 本 地 方法 renderPlasma。 接 


下 来 ， 我 们 分 析 C 代码 中 该 方法 的 实现 。 


9.3.4 本 地 方法 实现 


在 本 地 方法 实现 中 有 Android.mk 文件 和 plasma.c 文件 。 在 上 一 小 节 中 我 们 介绍 过 ， 


Androidmk 文件 是 对 so 文件 编译 时 的 描述 ，c 文件 是 具体 的 方法 实现 。 
1. Android.mk 


我 们 知道 在 .mk 文件 中 必须 描述 项 目 源 代码 的 文件 位 置 、 指 定 的 GUN 编译 、 编译 的 模 
板 、 编 译 的 源 文件 以 及 编译 的 类 型 。 在 本 例 中 ， 由 于 我 们 需要 依赖 其 他 的 库 文件 进行 编译 ， 





除了 上 述 描 述 之 外 ， 还 需要 对 依赖 库 的 描述 ， 使 用 到 的 描述 关键 字 为 : 


LOCAL LDLIBS 


其 为 可 执行 程序 或 者 库 的 编译 指定 额外 的 库 ， 指 定 库 的 格式 为 "-Ixxx"，xxx 为 库 名 。 


所 以 整个 mk 文件 如 下 : 


LOCAL PATH := $ (call my-dir) 
include $ (CLEAR VARS) 
LOCAL MODULE := plasma 
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LOCAL SRC FILES := Plasma-c 
LOCAL LDLIBS := -lm -llog -ljnigraphics 
include $ (BUILD SHARED LIBRARY) 


2. plasma.c 


从 Java 代码 中 , 我 们 可 以 发 现 仅仅 调用 了 本 地 方法 renderPlasma(Bitmap bitmap, long 
time ms)。 所 以 ， 我 们 重点 关注 该 方法 实现 的 流程 。 只 要 有 图 像 处 理 的 基础 都 知道 ， 在 等 
离子 Plasma 特效 的 实现 主要 需要 经 历 了 如 下 几 个 阶段 : 

(1) 初始 化 调 色 盘 表 

init_palette()， 这 个 方法 将 会 得 到 一 个 数组 palette[PALETTE _SIZE]， 通 过 查找 这 个 数 
组 的 下 标 来 得 到 对 应 代表 的 颜色 ， 由 palette from fixed( Fixed x ) 方 法 完成 查找 。 可 以 这 
样 理解 ， 即 bitmap 中 的 每 一 个 像素 都 拥有 一 个 数值 ， 每 个 数值 即 代 表 了 一 种 颜色 。 这 种 初 
始 化 调 色 盘 表 的 方法 在 图 像 处 理 中 经 常 使 用 ， 有 具体 实现 如 下 : 


static void init palette (void) 


{ 





int nn, mm = 0; 

for (nn = 0; nn < PALETTE SIZE/4; nn++) { 
int jj = (nn-mm)*4*255/PALETTE SIZE; 
palette[nn] = make565(255, jj, 255-jj); 

} 


for ( mm = nn; nn < PALETTE SIZE/2; nn++ ) { 
int jj = (nn-mm)*4*255/PALETTE SIZE; 
palette[nn] = make565(255-jj, 255, jj); 
} 


for ( mm = nn; nn < PALETTE SIZE*3/4; nn++ ) { 
int jj = (nn-mm)*4*255/PALETTE SIZE; 
palette[nn] = make565(0, 255-jj, 255); 

} 


Eor. ( mm = nn? nn < PALETTE STZE; nt { 
int jj = (nn-mm)*4*255/PALETTE SIZE; 
palette[nn] = make565(jj, 0, 255); 


(2) 初始 化 弧度 值 表 
init_angles()， 这 个 方法 也 将 生成 一 个 数组 angle_sin_tab[ANGLE 2PI+1]， 对 于 一 个 
Fixed 类 型 的 数值 通过 查找 该 数组 来 得 到 对 应 的 弧度 值 : 


static void init angles (void) 
{ 
int nn; 
for (nn = 0; nn < ANGLE 2PI+1; nn++) { 
double radians = nn*M PI/ANGLE PI; 
angle Sin tab[nn] = FIXED FROM FLOAT (sin(radians)); 


(3) 状态 相关 
初始 化 状态 使 用 参数 stats。 在 状态 中 保存 了 开始 时 间 、 持 续 时 间 、 帧 时 间 、 帧 状态 等 
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信息 。 初 始 化 过 程 如 下 : 


Statie vold Statso ime ES 
5s->lastTime = now ms(); // 获 取 当 前 时 间 
S->firstTime = 0.; 
s->firstFrame = 0; 
5->numFrames = 0; 


这 3 项 初始 化 都 是 需要 在 第 一 次 调用 该 方法 时 进行 的 。 当 初始 化 实现 后 ， 不 需要 再 进 
行 ， 只 需要 查询 初始 化 后 的 调 色 盘 表 和 弧度 表 即 可 。 
(4) 获取 图 像 信息 
获取 需要 绘制 的 bitmap 信息 使 用 方法 : 


AndroidBitmap getInfo (env，bitmap，&info) 


该 方法 是 Android 提供 的 本 地 API， 实 现 了 通过 传 入 的 bitmap 得 到 其 相关 信息 并 存储 
在 info 中 。 

(5) 锁定 图 像 

在 对 图 像 进行 绘制 时 ， 为 了 保证 其 唯一 性 ， 将 对 其 锁定 ， 使 用 方法 : 


AndroidBitmap lockPixels(env, bitmap, &pixels) 


该 方法 也 是 Android 提供 的 本 地 API。 该 方法 将 尝试 锁定 像素 在 内 存 中 的 地 址 ， 确 保 
这 段 内 存在 绘制 期 间 不 变 ， 直 到 unlockPixels0 方 法 被 调用 。 锁 定之 后 ，pixels 指向 图 片 的 
首 地 址 。 

(6) 状态 相关 

获取 状态 相关 数据 并 存 入 stats， 即 记录 帧 开始 的 时 刻 。 

(7) 绘制 Plasma 效果 

锁定 了 图 像 后 ， 我 们 需要 对 该 图 像 进行 重新 绘制 ， 实 现 Plasma 的 效果 。 实 现 Plasma 
效果 的 基本 思想 是 对 现 有 bitmap 图 像 ， 通 过 一 个 传 入 的 时 间 值 为 基础 ， 配 合 三 角 函 数 ， 在 
X 轴 和 立轴 上 按照 特定 的 增 量 来 计算 出 每 一 个 像素 的 值 ， 从 而 绘制 出 Plasma 的 效果 。 根 
据 这 一 基本 思想 ， 在 具体 实现 Plasma 特效 时 ， 其 方法 很 多 ， 其 中 一 种 具体 实现 如 下 : 


01 static void fill plasma( AndroidBitmapInfo* info, void* pixels, 





double 七 ) 

O20 

03 Fixed ft = FIXED FROM FLOAT(t/1000.); // 初 始 化 时 间 参 数 
04 Fixed ytl = FIXED FROM FLOAT(t/1230.); // 初 始 化 Y 轴 参 数 
05 Fixed yt2 = ytl; 

06 Fixed xt10 = FIXED FROM FLOAT(t/3000.); // 初 始 化 X 轴 参 数 
07 Fixed xt20 = xt10; 

08 


09 #define YTI INCR FIXED FROM FLOAT(1/100.)  // 定 义 Y 轴 增 量 1 
10 #define YT2 INCR FIXED FROM FLOAT(1/163.) 


el 

证 和 int yy; 

2 for (yy = 0; yy < info->height; yy++) { // 逐 点 变化 每 一 个 图 像 点 
14 uint16 t* line = (uint16 t*)pixels; 

15 Fixed base = fixed sin(yt1) + fixed sin(yt2); // 增 加 变化 


.405 。 


实战 Android 应 用 开发 








16 Fixed XE XEl0F // 定 义 X 轴 参数 1 
7 Fixed XE2 xE207 // 定 义 X 轴 参数 2 
18 ytl1 += YT1 INCR; 

19 yt2 += YT2 INCR; 

20 

21 #define XT1 INCR FIXED FROM FLOAT(1/173.) 

22 #define XT2 INCR FIXED FROM FLOAT(1/242.) 

23 

24 #if OPTIMIZE WRITES 


25 // 优 化 内 存 处 理 ， 生 成 的 每 一 个 像素 对 应 一 个 对 齐 的 32 位 存储 
26 uint16 t* line end = line + info->width; 
27 if (line < line end) { // 变 化 一 行 中 的 所 有 图 像 点 
28 if (((uint32 t)line & 3) !'= 0) { // 可 以 32 位 对 齐 的 点 
29 Fixed ii = base + fixed sin(xt1) + fixed sin(xt2); 
// 增 加 变 
30 xt1 += XT1 INCR; 
31 xt2 += XT2 INCR; 
32 line[0] = palette from fixed(ii >> 2);  // 获 取 该 点 颜色 
33 linett+; 
34 } 
35 
36 while (line + 2 <= line end) { // 
Eh Fixed il = base + fixed sin(xt1) + fixed sin(xt2); 
38 xt1 += XT1 INCR; 
39 xt2 += XT2 INCR; 
40 Fixed i2 = base + fixed sin(xt1) + fixed sin(xt2) 
41 xt1 += XT1 INCR; 
42 xt2 += XT2 INCR; 
43 uint32 t pixel = ((uint32 t)palette from fixed(il >> 2) 
<< Gil 
44 (uint32 t)palette from fixed(i2 >> 2) 
45 ((uint32 t*)line) [0] = pixel; 
46 line += 2; 
47 } 
48 
49 if (line < line end) { 
50 Fixed ii = base + fixed sin(xt1) + fixed sin(xt2); 
5 生 line[0] = Palette from fixed(ii >> 2); 
32 linett+; 
33 } 
54 1 
5 // 下 一 行 图 像 处 理 
56 Pixels = (char*)pixels + info->stride; 
57 } 
Se 


其 中 ，02 一 11 行 ， 根 据 传 入 的 时 间 对 XX 轴 和 YY 轴 增 量 等 参数 进行 初始 化 ; 


13 一 22 行 ， 对 整 张 图 像 的 所 有 像素 点 逐 行进 行 处 理 ， 获 取 该 行 的 位 置 ， 初始化 基本 变 
化 参数 ; 
23 一 26 行 ， 该 方法 进行 了 内 存 优化 。 由 于 一 个 像素 点 是 RGB 方式 存储 ， 是 一 个 32 位 


的 值 ， 所 以 进行 了 上 述 的 优化 ; 








27 一 53 行 ， 对 每 一 个 像素 点 进行 处 理 ， 每 一 个 像素 点 增 量 使 
三 base + fixed_sin(xtl) + fixed_sin(xt2) 计 算 而 得 ; 
55 一 56 行 ， 下 一 行 像素 处 理 。 











数学 计算 公式 : Fixed i 


当然 ， 这 里 对 存储 进行 了 优化 显得 处 理 过 程 有 些 复杂 ， 如 果 不 进行 内 存 优化 ， 每 一 行 
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中 实现 这 样 的 像素 点 增 量变 化 的 代码 如 下 : 


0 和 
02 for (xx = 0; xx < info->width; xx++) { // 人 遍历 一 行 中 的 所 有 点 
03 Fixed ii = base + fixed sin(xt1) + fixed sin(xt2); 
// 计 算 增 量 值 
04 二 ETETNCRZ // 增 量 1 改变 
05 xt2 += XT2 INCR; // 增 量 2 改变 
06 line[xx] = palette from fixed(ii / 4) ; // 获 取 颜 色 值 
07 } 


(8) 解除 锁定 

完成 了 Plasma 效果 的 bitmap 绘制 后 ， 解 除 对 内 存 中 图 像 的 锁定 ， 使 用 方法 : 

AndroidBitmap unlockPixels (env, bitmap) 

该 方法 也 是 Android 提供 的 本 地 API， 用 于 释放 对 内 存 的 锁定 。 与 方法 
AndroidBitmap_lockPixels() 匹 配 使 用 。 

(9) 状态 相关 

记录 一 帧 完成 时 的 相关 数据 ， 主 要 用 于 判断 绘制 图 像 的 性 能 ， 根 据 这 些 记录 的 数据 进 
行 Plasma 特效 形成 时 的 性 能 优化 。 熟 悉 了 等 离子 Plasma 特效 的 实现 主要 流程 ， 在 
renderPlasma 方法 中 就 是 对 该 过 程 的 实现 ， 其 流程 图 如 图 9.39 所 示 。 





Java_com_example _plasma _PlasmaView _renderPlasma 
(INIEnv * env, jobject obj , jobject bitmap , jlong 
time_ms) 


Init_tables (0); 
stats _init(&stats ); 


AndroidBitmap _ getInfo (en 
v, bitmap , &info) 





























AndroidBitmap _ lockPixels (en 
Vv. bitmap . &pixels ) 














stats _startFrame (&stats ); 














fill_plasma(&info, pixels. time_ms ): 








了 
AndroidBitmap _ unlockPixels (env. bitmap ); 


站 
stats_endFrame (&stats ); 





























图 9.39 ”renderPlasma 流程 图 
renderPlasma 方法 的 具体 代码 实现 如 下 : 
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01 JNIEXPORT void JNICALL Java com example Plasma PlasmaView render 
Plasma (JNIEnvV * env, 
02 jobject obj, jobject bitmap, jlong time ms) 


039 4 

04 AndroidBitmapInfo info; // 定 义 图 像 信息 类 

05 void* pixels; // 定 义 图 像 点 指针 

06 int ret; 

07 static Stats stats; // 定 义 状态 

08 static int init; 

09 // 完 成 调 色 盘 表 、 弧 度 表 以 及 状态 的 初始 化 

10 ny 

和 init tables(); 

2 stats init(&stats) : 

inat = 

14 } 

15 // 获 取 图 像 信 息 

16 if ((ret = AndroidBitmap getInfol(env, bitmap, &info)) < 0) { 
E LOGE ("AndroidBitmap getInfo() failed ! error=%d", ret); 
18 return; 

还 9 } 

20 if (info.format != ANDROID BITMAP FORMAT RGB 565){// 判 断 图 像 编码 类 型 
21 LOGE ("Bitmap format is not RGB 565 !"); 

Ep return; 

23 } 

24  // 锁 定 像素 地 址 

25 if ((ret = AndroidBitmap lockPixels(env, bitmap, gpixels)) < 0) { 
26 LOGE ("AndroidBitmap lockPixels() failed ! error=%d", ret); 
区 多 } 

28 ”// 修 改 开 始 帧 状态 

29 stats startFrame (gstats); 

30 ”// 绘 制 Plasma 图 像 帧 

3 fill plasma(&info, pixels, time ms ); 

32 // 解 除 像素 锁定 

33 AndroidBitmap unlockPixels (env, bitmap); 

34 ”// 修 改 结 束 帧 状态 

35 stats endFrame (&stats); 

360 


其 中 ，01 一 02 行 ， 定 义 用 于 JNI 调用 的 导出 函数 。 注 意 其 函数 定义 的 规则 ; 

03 一 08 行 ， 定 义 需 要 使 用 到 的 参数 变量 ; 

09 一 14 行 ， 当 第 一 次 调用 该 方法 时 ， 初 始 化 调 色 盘 表 、 弧 度 表 以 及 状态 ; 

15 一 23 行 ， 获 取 图 像 信息 ， 并 判断 该 图 像 是 否 为 RGB 方式 存储 的 图 像 ; 

24 一 27 行 ， 锁 定 图 像 ， 并 获取 图 像 首 地 址 ; 

28 一 29 行 ， 修 改 开始 帧 状态 ， 主 要 获取 当前 时 间 ; 

30 一 31 行 ， 以 传 入 的 时 间 为 基础 ， 使 用 三 角 函 数 产生 像素 点 之 间 的 连续 变化 ， 绘 制 出 
Plasma 效果 的 图 像 ; 

32 一 33 行 ， 绘 制图 像 完成 后 ， 解 除 对 图 像 的 锁定 ; 

34 一 35 行 ， 完 成 该 图 像 帧 的 绘制 后 ， 记 录 该 帧 完成 时 的 相关 数据 。 





9.3.5 ”运行 总 结 


调试 修改 并 运行 代码 ， 效 果 如 图 9.38 所 示 。 在 本 示例 中 的 等 离子 Plasma 效果 实现 过 
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程 中 ， 我 们 可 以 很 明显 地 感觉 到 在 Java 代码 中 ， 需 要 实现 的 部 分 很 少 ， 只 是 调用 实现 的 本 
地 方法 而 已 。 而 重点 在 本 地 方法 中 ， 实 现 Plasma 效果 都 是 使 用 C 语言 ， 不 需要 对 Android 
的 框架 有 任何 的 依赖 ， 只 需要 熟悉 C 语言 中 Plasma 效果 实现 即 可 。 这 样 的 设计 很 好 地 将 
依赖 Android 框架 的 应 用 开发 和 高 效 运行 的 C 代码 分 开 ， 即 满足 了 高 效 的 要 求 又 可 以 使 用 
已 有 成 熟 的 图 像 处 理 相关 C 代码 。 





9.4 水 波纹 效果 





在 界面 效果 中 , 我 们 经 常 可 以 看 到 水 波纹 效果 。 这 种 雨水 滴 落 水 中 而 产生 的 涟 游 效果 ， 
让 人 有 一 种 下 雨 的 感觉 。 在 实现 水 波纹 效果 的 时 候 ， 必 然 需要 认真 考虑 在 物理 课 上 我 们 所 
学 的 关于 水 波 的 知识 ， 水 波 具 有 扩散 、 衰 减 、 折 射 、 反 射 、 衍 射 等 特性 。 由 于 这 么 多 的 特 
性 ， 使 用 Java 来 实现 水 波纹 效果 ， 即 使 是 简化 后 的 水 波纹 效果 ， 由 于 Java 本 身 效 率 很 低 ， 
不 容易 达到 效果 。 在 本 节 中 ， 我 们 使 用 NDK 来 实现 水 波纹 效果 。 





9.4.1 交互 实现 


通过 前 面 章节 的 介绍 , 我 们 已 经 明确 了 在 NDK 中 主要 实现 的 是 效率 要 求 较 高 的 方法 。 
所 以 接 下 来 ， 我 们 分 为 Java 完成 的 应 用 程序 主体 框架 的 实现 和 NDK 核心 算法 的 实现 两 部 
分 进行 讲解 。 

在 用 户 交互 的 界面 中 ， 我 们 只 需要 在 视图 View 中 获取 用 户 单 击 的 位 置 ， 然 后 以 此 位 
置 为 源头 进行 水 波 扩散 ， 实 现 效果 如 图 9.40 所 示 。 
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图 9.40 水 波纹 效果 
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1. NDK 项 目 创建 


首先 我 们 新 建 一 个 NDK 项 目 。 创建 项 目的 过 程 在 9.2 节 中 详细 介绍 过 ， 可 以 分 为 3 步 : 
(1) 创建 一 个 Android 项 目 。 

(2) 添加 NDK 本 地 支持 。 

(3) 设置 NDK 编译 环境 和 添加 NDK 开发 依赖 库 。 

经 过 以 上 3 步 ， 我 们 可 以 创建 一 个 NDK 开发 空 项 目 。 


2. Activity 创 建 


由 于 在 本 示例 中 ， 主 要 是 实现 水 波纹 的 效果 ， 因 此 在 界面 中 只 是 提供 了 一 个 可 以 单 击 
的 视图 View， 在 直接 呈现 给 用 户 的 Activity 中 ， 只 需要 显示 该 View 即 可 。 在 实现 Activity 
时 ， 我 们 使 用 代码 动态 实现 该 布局 即 可 ， 实 现 如 下 : 





01 public void onCreate (Bundle savedInstanceState) { 
02 super.onCreate (savedInstanceState); 
03 getWindow() .setFlags( 
04 WindowManager.LayoutParams .FLAG FULLSCREEN， 
05 WindowManager.LayoutParams .FLAG FULLSCREEN); 
// 设 置 图 片 全 屏 显示 
06 m waterview = new Waterview(this) : // 实 例 化 
07 setContentView (m waterview); 
08 } 


其 中 ，03 一 05 行 ， 设 置 了 显示 为 全 屏 显示 ; 

06 行 ， 实 例 化 显示 的 View 对 象 ， 在 View 对 象 中 我 们 将 实现 对 用 户 单 击 事件 的 处 理 
和 水 波纹 图 像 的 绘制 过 程 。 

3. View 实 现 


在 View 视图 中 ， 我 们 需要 获取 用 户 单 击 的 位 置 ， 还 需要 不 断 地 重 绘制 显示 图 像 ， 以 
便 连贯 地 显示 出 雨点 滴 落 水 中 而 产生 的 涟 游 效果 。 为 了 让 用 户 感觉 更 流畅 ， 在 视图 View 
中 ， 我 们 使 用 一 个 新 的 线程 来 负责 不 断 重 新 绘制 图 像 的 工作 。 

(1) 构造 函数 

在 显示 View 视图 的 构造 函数 中 ， 我 们 需要 明确 显示 的 图 像 ， 并 初始 化 需要 使 用 到 的 
变量 参数 。 我 们 需要 使 用 这 些 参数 保存 图 像 的 高 度 、 宽 度 、 图 像 数组 等 ， 具 体 的 原理 将 在 
下 一 小 节 中 描述 。 构 造 函数 的 实现 如 下 : 


01 public class Waterview extends View implements Runnable{ 





02 

03 public Waterview (Context context) { // 构 造 函数 

04 super (context); 

05 Bitmap image = BitmapFactory .decodeResource (this .getResources () ， 
R.drawable.black); 

06 m width = image.getwidth(); // 获 取 图 像 宽度 

07 m height = image.getHeight () // 获 取 图 像 高 度 

08 // 用 于 保存 波动 幅度 

09 m bufl = new short[m width * (m height)]; 

10 m buf2 = new short[m width * (m height)]; 

el // 用 于 保存 图 像 
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这 m bitmapl = new int[m width * m height]; 

13 m bitmap2 = new int[m width * m height]; 

14 // 获 取 图 像 数组 

15 image.getPixels (m bitmapl, 0, m width, 0, 0, m width, m height); 
16 // 开 启 线程 

Eh start(); 

18 } 

19 } 


其 中 ，01 行 ， 表明 实 现 的 View 视图 类 ， 不 仅 继承 了 基本 的 视图 View， 还 需要 实现 
线程 ; 

05 行 ， 获 取 显示 的 背景 图 片 ， 我 们 将 对 该 图 像 进 行 水 波 效果 处 理 ; 

06 一 13 行 ， 初 始 化 需要 使 用 到 的 保存 数据 的 变量 ; 

14 一 15 行 ， 获 取 图 像 数 组 。 

(2) 获取 单 击 位 置 

我 们 知道 水 波纹 就 是 从 一 个 源 点 向 周围 扩散 的 波动 。 用 户 单 击 的 位 置 便 是 我 们 实现 水 
波纹 的 源 点 。 在 View 中 获取 用 户 单 击 位 置 的 实现 如 下 : 

01 Q@Override 

02 public boolean onTouchEvent (MotionEvent event) {  // 触 摸 屏幕 事件 








03 int action = event.getAction(); 

04 int x = (int) (event.getX()); // 获 取 触 摸 点 的 X 轴 值 
05 int y = (int) (event.getY()) // 获 取 触 摸 点 的 Y 轴 值 
06 

07 switch (action) { 

08 case MotionEvent.ACTION DOWN: // 屏 幕 单 击 事件 

09 dropStone (x, y, 8, 50); // 调 用 NDK 的 波浪 源 方 法 
10 m preX = x; 

让 mpreY = ys 

和 人 Log.i(TAG, "the down xy is "+x+","+y); 

13 break; 

14 

15 } 

16 return super.onTouchEvent (event); 

站 


其 中 ，02 一 05 行 ， 重 写 单 击 onTouchEvent0 事 件 ， 获 取 单 击 的 位 置 ; 

08 行 ， 判 断 事件 动作 是 否 为 单 击 ， 如 果 是 单 击 则 进行 波源 处 理 ; 

09 行 ， 用 于 进行 波源 处 理 的 函数 ， 将 在 NDK 中 实现 。 

(3) 重 绘图 像 

在 图 像 处 理 时 ， 我 们 将 不 断 地 对 图 像 进行 水 波纹 效果 处 理 ， 每 完成 一 次 处 理 就 需要 及 
时 地 在 显示 图 像 中 进行 绘制 。 整 个 重 绘图 像 的 逻辑 过 程 实现 如 下 : 


01 public void start() { 


02 m isRunning = true; 

03 m thread = new Thread(this); 

04 m thread. start (); // 启 动 绘图 线程 
5 

06 


07 Q@Override 
08 public void run() { 
09 while (m isRunning) { 


10 jmakeRipple (); // 调 用 NDK 波浪 处 理 方法 
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ia postInvalidate(); // 提 交 UI 更 新 
12 } 
3 


15 Q@Override 
16 Protected void onDraw (Canvas canvas) { 


yy canvas .drawBitmap (mm bitmap2, 0, m width, 0, 0, m width, m height, 
false, null); // 绘 制图 像 

18 Log.i(TAG, "ondraw"); 

9% 


其 中 ，01 一 05 行 ， 该 函数 在 实现 的 Waterview 类 的 构造 函数 中 调用 ， 用 于 实现 并 开启 
一 个 新 的 线程 ; 

07 一 13 行 ， 线 程 的 运行 函数 。 其 中 ，10 行 就 是 使 用 NDK 实现 的 图 像 波 动 处 理 方法 ; 
11 行 是 提交 图 像 UI 更 新 ; 

15 一 19 行 ， 图 像 更 新 时 ， 绘 制图 像 。 图 像 根据 数组 m_bitmap2 进行 绘制 ， 而 进行 了 水 
波纹 处 理 的 图 像 元 素 便 保存 在 该 数组 中 。 

通过 以 上 步 台 ,我 们 实现 了 整个 应 用 程序 的 逻辑 框架 。 当 然 ， 在 使 用 so 库 之 前 ， 我 们 
还 需要 定义 库 名 以 及 需要 使 用 的 本 地 方法 ， 实 现 如 下 : 





statict{ 
System.loadLibrary ("Jniwaterwave"); // 加 载 库 
， 
private native void jmakeRipple(); // 定 义 NDK 波浪 图 像 生成 方法 
private native void jdropStone (int x, int y,int stoneSize,int stoneWeight) 


// 定 义 NDK 波浪 源 方法 


9.4.2 ”NDK 实现 


在 NDK 中 ， 我 们 需要 实现 最 核心 的 图 像 水 波 变化 处 理 算 法 。 在 实现 水 波纹 效果 处 理 
之 前 ， 我 们 需要 简单 回顾 一 下 水 波 原理 。 


1. 基本 原理 


水 波纹 效果 就 是 当 雨 点 滴 落 到 水 面 时 ， 产 生 的 一 圈 圈 水 波纹 涟 游 效 果 。 从 物理 学 知识 
中 ， 我 们 知道 水 波 具 有 儿 个 基本 特性 ， 即 扩散 性 、 衰 减 性 、 折 射 性 、 反 射 性、 衍射 性 等 。 
其 中 ， 在 图 像 处 理 过 程 中 必须 考虑 的 几 个 特性 如 下 : 
口 扩散 性 ， 当 雨点 滴 落 到 水 面 时 ， 产 生 以 雨点 为 圆心 所 形成 的 一 圈 圈 的 水 波 ， 并 非 
水 波 上 的 每 一 点 都 是 以 雨点 为 中 心 向 外 扩散 的 。 而 实际 上 ， 水 波 上 的 任何 一 点 在 
任何 时 候 都 是 以 自己 为 圆心 向 四 周 扩散 的 ， 之 所 以 会 形成 一 个 环 状 的 水 波 ， 是 由 
于 水 波 的 内 部 由 于 扩散 的 对 称 而 相互 抵消 了 。 
口 衰减 性 ， 因 为 水 是 有 阻尼 的 ， 当 产生 波动 时 是 会 发 生 能 量 的 衰减 的 。 
口 折射 性 : 因为 在 水 波 上 不 同 地 点 的 倾斜 角度 不 同 ， 所 以 我 们 从 观察 点 垂直 往 下 看 
到 的 水 中 的 图 像 并 不 是 在 观察 点 的 正 下 方 ， 而 有 一 定 的 偏 移 。 如 果 不 考虑 水 面 上 
部 的 光线 反射 ， 这 就 是 我 们 能 感觉 到 水 波形 状 的 原因 。 
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2. 波幅 计算 


在 实现 水 波纹 效果 时 ， 我 们 需要 根据 扩散 性 和 衰减 性 来 对 震动 的 波幅 进行 计算 。 如 果 
安装 严格 的 波幅 计算 将 使 用 到 非常 复杂 的 数学 公式 。 对 于 手机 设备 来 说 ， 这 样 严格 的 计算 
将 牺牲 实现 图 像 的 流畅 性 ， 而 实现 效果 的 逼真 性 并 不 能 带 来 很 大 的 提高 。 在 本 示例 中 ， 使 
用 了 一 种 水 波纹 的 快速 算法 。 它 的 计算 既 没 有 用 到 sin、cos 函数 也 没有 用 到 sin、cos 函数 
的 查 表 算 法 ， 它 只 是 根据 波 的 传播 原理 ， 通 过 少量 的 加 减 、 位 移 运算 来 完成 。 
该 算法 认为 可 以 在 任意 时 刻 某 一 个 点 的 波幅 ， 由 该 点 周围 前 、 后 、 左 、 右 4 个 点 以 及 
该 点 自身 的 振幅 来 推算 出 下 一 时 刻 该 点 的 振幅 。 
当 不 考虑 水 阻尼 衰减 情况 下 ， 得 出 的 近似 公式 为 : 
X0’ = (Xl +X2+X3+X4) /2_X0 
即 已 知 某 一 时 刻 水 面 上 任意 一 点 的 波幅 ， 那 么 在 下 一 时 刻 ， 该 点 的 波幅 就 等 于 与 该 点 
紧邻 的 前 、 后 、 左 、 右 4 点 的 波幅 的 和 除 以 2、 再 减 去 该 点 的 波幅 。 
当 考 虑 水 阻尼 衰减 时 ， 衰 减 率 经 过 测试 使 用 1/32 是 比较 合适 。 所 以 ， 波 幅 的 近似 计算 
公式 为 : 
XO0’ = (XIF X24 RIF RAY INO0) 132 
3. NDK 波 幅 计算 实现 


在 界面 视图 View 的 构造 函数 中 ， 我 们 使 用 了 m_width、m_height 来 保存 背景 图 像 的 
宽度 和 高 度 ; 使 用 m_bufl、m_buf2 数组 分 别 保 存 图 像 各 点 的 上 一 时 刻 和 下 一 时 刻 的 波动 
幅度 ， 使 用 m_bitmap1、m_bitmap2 数组 分 别 保存 图 像 发 生 波动 前 、 后 的 泻 染 图像 。 所 以 ， 
在 进行 波幅 计算 之 前 ， 我 们 需要 从 Java 类 中 获得 这 些 数据 。 

(1) 获取 Java 类 数据 

在 Jni 本 地 方法 中 可 以 调用 Java 类 中 声明 为 public 的 变量 和 方法 。 首 先 , 需要 获取 Java 
对 象 ， 使 用 方法 : 


jclass GetObjectClass (UNIEnv *env, jobject obj); 


其 中 ， 返 回 为 Java 类 对 象 。 参数 分 别 为 本 地 方法 定义 时 必须 的 两 个 参数 。 获 取 了 Java 
对 象 后 ， 便 可 以 获取 Java 类 中 的 公开 变量 和 方法 的 ID， 分 别 使 用 方法 : 





jfieldID topicFieldId = env->GetFieldqID(objectClass,"name"，"Ljava/lang/ 
SEring>™)? 
jmethodID getcName=env->GetMethodID (objectClass, "getcatName","()Ljava/lang/ 
SEringa nhs 


其 中 ， 第 一 个 方法 是 获取 Java 类 中 的 公开 变量 。 第 一 参数 objectClass 是 Java 类 对 象 ， 
dee name 是 变量 名 称 ， 第 三 个 参数 是 该 参数 的 签名 ; 第 二 个 方法 是 获取 Java 类 中 
的 公开 方法 。 
对 于 上 述 方法 中 第 三 个 参数 签名 ， 常 用 的 类 型 对 应 的 签名 如 表 9-2 所 示 。 
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表 9-2 类 型 签名 表 





























的 


Java 类 型 本 地 类 型 签名 
boolean jboolean 中 
byte jbyte B 
char jchar 心 
short jshort S 
int jint I 
long jlong J 
float Jfloat F 
double jdouble D 
void void V 
nonprimitive jobject 工 








然 ， 如 果 你 不 能 正确 推算 出 各 个 变量 或 者 方法 的 对 应 签名 ， 可 以 使 用 Java 自 带 的 


py 

Javap -s 类 名 

首先 ， 对 Java 类 进行 编译 ， rime class 文件 的 目录 ， 输 入 该 命令 即 可 。 
于 本 示例 中 的 Waterview， 获 取 签 名 过 程 如 下 : 


D:\Documents and Settings\Owner>E: 
E:\>cd E:\Android\works\Jniwaterwave\bin\classes\com\ouling\Jniwaterwave 
E:\Android\works\Jniwaterwave\bin\classes\com\ouling\Jniwaterwave>javap 
-s Waterview 
Compiled from "Waterview.java" 
public class com.ouling.Jniwaterwave.Waterview extends android.view.View 
impleme 
nts java.lang.Runnable{ 
static java.lang.String TAG; 
Signature: Ljava/lang/String; 
boolean m isRunning; 
Signature: Z 
boolean m isRain; 
Signature: Z 
int m width; 
Signature: I 
int m height; 
Signature: I 
short[] m bufl: 
Signature: [S 
本 省略 过 二 
} 


从 输入 中 可 以 很 明显 地 看 出 , 变量 m_width 的 签名 是 “I”, 而 m_bufl 的 签名 是 “[S”。 
获取 了 Java 类 中 的 公开 变量 和 方法 的 ID 后 , 便 可 以 根据 字段 人 D 获取 字段 的 值 。 具体 
方法 根据 数据 类 型 的 不 同 而 不 同 ， 一 般 性 的 表示 方法 如 下 : 


NativeType Get<Type>Field(JNIEnv *env, jobject obj, jfieldID fieldID); 


其 中 ， 返 回 值 为 本 地 数据 类 型 。 方 法 名 根据 返回 类 型 的 不 同 而 不 同 。 例 如 ， 对 于 本 示 

















例 中 的 宽度 值 获取 使 用 的 方法 为 GetImtField0。 





通过 这 样 的 方法 ， 我 们 就 可 以 直接 使 用 Java 类 中 的 公开 变量 和 方法 。 在 本 示例 中 ， 计 
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算 波幅 需要 获得 m_ width、m height、m_ bufl 数组 以 及 m_buf2 数组 。 获 取 这 些 变量 的 具 


体 实 现 如 下 : 

01 // 获 取 Java 对 象 

02 jclass jclassThiz = (kenv) ->GetObjectClass(env, thiz); 

03 ”// 宽 度 

04 jfieldIiD fid Width = (*env)->GetFieldID (env, jclassThiz, "m width", 
"I"); 

05 jint sWidth = (*env)->GetIntField(env, thiz, fid Width); 

06 // 高 度 

07 jfieldID fid height = (*env)->GetFieldID (env, jclassThiz, "m height", 
"In); 

08 jint sHeight = (*env)->GetIntField(env, thiz, fid height); 

09 // 数 据 缓存 buf1 

10 jfieldID fid bufl = (*env)->GetFieldID(env, jclassThiz, "m buf1", 
"[Ss"); 

11 jshortArray bufl arr = (jshortArray) (*env)->GetObjectField(env, thiz, 
fid buf1); 

12 jshort *bufl = (*env)->GetShortArrayElements (env, bufl arr, 0); 

13 jsize buf len = (*env)->GetArrayLength(env, bufl arr); 

14 ”// 数 据 缓存 buf2 

15 jfieldID fid buf2 = (*env)->GetFieldID(env, jclassThiz, "m buf2", 
| 

16 jshortArray buf2 arr = (jshortArray) (*env)->GetObjectField(env, thiz, 
fd Due2)s 

17 jshort *buf2 = (*env)->GetShortArrayElements (env, buf2 arr, 0); 

18 jsize buf2 len = (*env)->GetArrayLength(env, buf2 arr); 


其 中 ，02 行 ， 获 取 Java 类 对 象 ， 用 于 获取 该 对 象 中 的 公开 变量 中 的 ID 号 ; 

04 行 ， 获 取 m_width 变量 的 ID 号 。 其 中 ， 参 数 m_width 为 变量 名 ;参数 I 为 签名 ; 

05 行 ， 获 取 宽 度 m_width 变量 的 值 ; 

06 一 18 行 ， 通 过 类 似 的 方法 获取 得 到 图 像 的 高 度 、bufl 数组 、buf2 数组 的 值 。 

(2) 波幅 计算 

从 Java 类 中 获得 了 需要 使 用 的 变量 之 后 , 对 于 波幅 的 计算 按照 波幅 计算 的 近似 公式 进 
行 计 算 即 可 ， 具 体 实现 如 下 : 


01 
02 
03 
04 
05 
06 


07 
08 
09 
10 
ls 
2 
13 


k = sWidth; 
jint pixels = sWidth * (sHeight - 1); // 获 取 所 有 图 像 点 
jint i = swidth; 


while (i < pixels) { // 计 算 每 一 个 点 的 波幅 值 
buf2[i] = (jshort) (((bufl[i - 1] + bufl[i + 1] + bufl[i - sWidth] 
+ bufl[i + sWidth]) >> 1) - buf2[i]); 
buf2[i] -= buf2[i] >> 5; // 计 算 阻 尼 下 的 波幅 
全 未 下 
} 
jshortArray temp = bufl; 


bufl 
buf2 


buf2; 
temp; 


其 中 ，01 一 03 行 ， 获 取 图 像 数 组 的 大 小 。 由 于 图 像 点 是 一 个 二 维 的 点 ,但 是 这 些 点 保 
存在 一 维 数组 中 ， 需 要 进行 转换 ; 
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一 维 数组 的 位 置 。 该 点 的 前 、 后 一 点 ， 在 数组 中 加 减 1; 该 点 的 上 、 下 一 点 ， 数 组 中 加 减 
图 像 的 宽度 值 ， 二 是 在 计算 机 中 除 以 2 等 同 于 数 右 移 一 位 ， 类 似 地 除 以 32 等 同 于 右 移 5 
位 ， 而 且 移 位 计算 效率 更 高 ; 


07 
4. 


在 
该 偏 移 


由 


行 ， 计 算 真 实情 况 下 ， 考 虑 水 阻尼 衰减 下 的 波幅 。 
图 像 折射 偏 移 实现 
前 面 分 析 水 波 特性 时 , 我 们 知道 因为 水 的 折射 , 图 像 在 显示 时 是 存在 一 定 的 偏 移 的 。 


的 程度 与 水 波 的 斜率 、 水 的 折射 率 以 及 水 的 深度 都 有 关系 。 对 于 如 此 复杂 的 情况 ， 


如 果 进 行 精确 的 计算 是 不 现实 的 。 同 样 ， 我 们 使 用 一 种 线性 的 近似 处 理 算 法 来 实现 。 该 算 


法 近似 


地 认为 ， 当 水 面 越 倾斜 ,所 看 到 的 水 下 景物 偏 移 量 就 越 大 ， 所 以 ， 我 们 可 以 近似 地 





用 水 面 上 某 点 的 前 后 、 左右 两 点 的 波幅 之 差 来 代表 所 看 到 水 底 景 物 的 偏 移 量 。 该 偏 移 量 为 : 


of 


二 


滨 


fset = width * yoffset + xoffset 


此 在 程序 中 , 用 一 个 页 面 装载 原始 的 图 像 , 用 另外 一 个 页 面 来 进行 这 样 的 偏 移 处 理 。 





用 根据 偏 移 量 将 原始 图 像 上 的 每 一 个 像素 复制 到 演 染 页 面 上 。 进 行 页 面 泻 染 的 代码 如 下 ;: 


01 
02 
03 


04 


05 


06 
07 


08 


09 
10 
了 
二 有 
13 
14 
5 
16 
7 
18 


3 
20 
eal 
岂 辽 
23 
24 
25 


其 


jclass jclassThiz = (*env) ->GetObjectClass (env, thiz); 

//bitmapl 

jfieldID fid bitmapl = (*env)->GetFieldID(env, jclassThiz, "m bitmapl 
mm[In) ， 

I bitmapl arr = (jintArray) (*env)->GetObjectField(env, thiz, 
fid bitmap1); 

jint *bitmapl = (*env)->GetIntArrayElements (env, bitmapl arr, 0); 
//bitmap2 

jfieldID fid bitmap2 = (*env)->GetFieldID(env, jclassThiz, "m bitmap2 
mI); 

a bitmap2 arr = (jintArray) (*env)->GetObjectField(env, thiz, 
fid bitmap2); 


jint *bitmap2 = (*env)->GetIntArrayElements (env, bitmap2 arr, 0); 
jint offset; 
i = sWidth; 
jint length = sWidth * sHeight; 
nt y= 
for (y= Ly < sHeight 1 tty) { // 遍 历 图 像 点 所 有 列 
jn = 
for (x = 0; x < sWidth; ++x, ++i) { // 遍 历 图 像 点 一 行 
offset = (sWidth* (bufl[i- sWidth] - bufl[i + sWidth])) + (bufl[i 
LI PuEl ID // 计 算 偏 移 
if (i + offset > 0 && i + offset < length) {// 判 断 是 否 在 边界 以 内 
bitmap2[i] = bitmapl[i + offset]; // 改 变 该 点 图 像 值 
} else { 
bitmap2[i] = bitmap1[i]; // 不 改变 该 点 图 像 值 
} 


} 
中 ，01 一 09 行 ， 获取 Java 对 象 中 分 别 用 于 保存 图 像 发 生 波动 前 后 的 泻 染 图 像 的 





m_bitmap1、m_bitmap2 数组 ; 


“416。 


第 9 章 AndroidNDK 开发 








15 一 25 行 ， 根 据 偏 移 量 进行 图 像 的 偏 移 处 理 。 
5. 波源 实现 





前 面 进行 的 处 理 都 是 当 水 面 已 经 产生 了 波纹 之 后 的 波纹 扩散 和 能 量 衰减 处 理 。 接 下 


来 





实现 雨点 滴 落 到 水 面 时 的 波源 产生 。 我 们 知道 波源 是 具有 一 定 的 大 小 和 能 量 的 。 对 于 


能 量 ， 通 过 修改 波 能 数据 缓冲 区 buf， 让 它 在 波源 范围 有 一 个 初始 值 ， 即 buf[x.y] =n 即 可 。 


而 对 于 波源 





E 径 中 的 所 有 点 ， 都 类 似 地 认为 获得 的 能 量 是 相同 的 。 


因此 ， 在 用 户 单 击 的 点 (x,y) 的 波源 半径 stoneSize 中 ， 所 有 的 点 都 初始 能 量 为 


stone Weight, 


01 voi 





nl 


则 该 波源 的 具体 实现 如 1 


d Java com ouling Jniwaterwave Waterview jdropStone (JNIEnv# env, 


jobject thiz, jint x, jint y, 
02 jint stoneSize, jint stoneWeight) { 


03 
04 
05 


06 


07 


08 
09 


10 
ll 
12 
3 
14 
ER 


16 
bs 


18 
19 
20 
忆 二 


22 
2 


jclass jclassThiz = (*env)—->GetObjectClass (env, thiz); 
//buf1 
jfieldID fid bufl = (*env)->GetFieldID (env, jclassThiz, "m bufl"， 
"[s"); 
jshortArray bufl arr = (jshortArray) (*env)->GetObjectField(env, 
thiz Eio bos) 
jshort *bufl = (*env)->GetShortArrayElements (env, bufl arr, 0); 
// 图 像 宽度 
jfieldID fid Width = (*env)->GetFieldID (env, jclassThiz, "m width", 
nmTn) 
jint swWidth = (*env)->GetIntField(env, thiz, fid Width) 7 
// 能 量 初始 值 
jint value = stoneSize * stoneSize; 
jshort weight = (jshort)-stoneWeight; 


jint posx; 
for ( posx = x - stoneSize; posx < x + stoneSize; ++posx){ 
// 遍 历 半 径 内 X 轴 点 
jint posy; 
for ( posy = y - stoneSize; posy < y + stoneSize; ++posy) 
// 半 径 内 YY 轴 点 
TE ((posx x) + (posx ZHI(posy y+* (posy ye< 
value) { // 判 断 是 否 为 圆 内 的 点 
bufl[sWidth * posy + posx] = weight; 
// 增 加 所 有 圆 内 点 的 波幅 
} 
} 
} 


} 


其 中 ，01 一 02 行 ， 对 波源 本 地 方法 函数 的 定义 ; 
03 一 10 行 ， 获 取 Java 类 对 象 中 保存 其 波幅 和 宽度 的 变量 ; 
12 一 23 行 , 改变 在 以 点 (x,y) 为 圆心 、stoneSize 为 半径 的 圆 中 的 所 有 点 的 波幅 为 weight。 





9.4.3 ”运行 分 析 


通过 以 上 步骤 ， 我 们 分 别 根据 物理 原理 分 析 了 水 波纹 实现 过 程 中 需要 考虑 的 真实 的 波 
源 、 波 幅 、 能 量 衰 减 以 及 反射 显示 等 情况 ， 对 于 这 些 图 像 泻 染 的 处 理 ， 我 们 都 使 用 了 成 熟 
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的 算法 来 进行 处 理 。 实 现 了 以 用 户 单 击 点 为 波源 的 水 波纹 效果 ， 如 图 9.40 所 示 。 

通过 本 节 水 波纹 的 实现 ， 我 们 掌握 了 如 何在 Jni 本 地 方法 中 获取 Java 类 中 公开 变量 、 
公开 方法 ， 并 实现 了 成 熟 的 水 波纹 处 理 算法 。 在 这 些 算 法 的 实现 过 程 中 ， 我 们 可 以 看 出 都 
进行 了 一 次 循环 甚至 谋 套 循环 处 理 ， 这 些 都 需要 进行 大 量 的 计算 ， 我 们 将 这 些 计算 都 剥离 
到 NDK 本 地 方法 中 进行 实现 。 


95 本 章 总 结 


本 章 介 绍 了 Android 中 NDK 相关 的 开发 。 通 过 Windows 平台 中 NDK 开发 环境 的 搭 
建 、 开 发 基本 的 NDK 项 目 、 分 析 NDK 示例 以 及 实现 水 波纹 效果 ， 详 细 介 绍 了 Android 系 
统 中 NDK 的 适用 情况 以 及 使 用 NDK 的 基本 方法 ， 这 些 都 是 本 章 的 重点 。 

NDK 主要 用 于 实现 效率 要 求 较 高 的 图 形 图 像 泻 染 、 高 清 视 频 播放 以 及 防止 反 编译 等 情 
况 ， 适 合 C/C++ 代码 的 移植 。 这 些 都 不 再 是 基本 的 Android 开发 所 需要 具备 的 技能 ， 而 是 
Android 开发 扩展 和 进 阶 的 必 经 道路 。 


9.6 习 题 


【习题 1】 掌 握 搭 建 NDK 开发 环境 的 过 程 。 
【习题 2】 分 析 学 习 NDK 开发 包 中 的 示例 代码 ， 重 点 是 two-libs 和 native-activity。 
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我 们 下 面 来 学 习 一 个 相对 简单 的 例子 : 文件 管理 器 ， 主 要 功能 包括 浏览 Android 中 的 
文件 夹 和 文件 ， 将 其 可 视 化 地 显示 出 来 并 对 文件 进行 简单 的 操作 。 我 们 先 来 思考 一 下 如 何 
完成 一 个 文件 管理 器 ， 首 先 我 们 需要 针对 不 同 的 文件 类 型 进行 显示 ， 这 其 中 包括 文本 类 文 
件 、 图 片 类 文件 、 压 缩 类 文件 、 多 媒体 类 文件 以 及 文件 夹 。 


10.1 界面 资源 布局 


首先 ， 我 们 需要 考虑 如 何 布局 界面 ， 一 般 情况 下 ， 大 家 都 会 想到 使 用 一 个 Listview 来 
显示 一 个 文件 夹 中 包含 了 哪些 文件 ， 每 一 个 Listview Item 中 包括 图 标 、 文 件 名 ， 分 别 要 用 
ImageView 控件 和 TextView 控件 。 在 ListView 底部 或 者 顶端， 需要 包含 对 文件 进行 操作 
的 按钮 ， 复 杂 的 例如 : 增加 、 删 除 、 重 命名 、 复 制 、 粘 贴 等 ， 还 需要 包含 导航 键 ， 比 如 返 
回 上 一 级 目录 、 后 退 和 前 进 。 

在 本 例 中 , 我们 将 学 习 一 种 新 的 布局 方法 ,不 在 Layout 文件 夹 的 xml 文件 中 布局 ,而 
在 Java 文件 中 通过 代码 来 布局 。 

首先 ， 我们 先 来 寻找 一 些 用 于 显示 不 同文 件 类 型 的 图 标 ， 大 小 是 32X32。 图 标 如 果 是 
128X128 的 话 会 比较 大 ， 经 测试 应 用 程序 不 太 稳定 ， 比 较 容易 崩溃 ， 图 标 如 图 10.1 所 示 : 


9 ao 





Fadio pnd) folder, png oroot .PNG icon png 
- 
inage. png Packed pne text. pne wponelevel. PHG 


图 10.1 各 种 文件 类 型 的 图 标 


上 图 中 的 icon 是 应 用 程序 显示 在 设备 上 的 图 标 ， 所 以 较 大 ， 尺 寸 是 128X 128。 
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我 们 新 建 一 个 名 为 Myfilemanager 的 工程 ,将 以 上 图 标 复制 到 drawable-hdpi 文件 夹 中 ， 
同时 删除 drawable-mdpi 和 drawable-ldpi 文件 夹 , 以 及 删除 layout 文件 中 的 main.xml 文件 。 
这 时 在 MyfilemanagerActivity 中 会 报错 ， 原 因 是 代码 setContentView(R.layout.main) 报 错 ， 
这 行 代 码 的 意思 是 程序 运行 后 ， 先 生成 main.xml 中 的 布局 ， 现 在 main.xml 被 我 们 删除 了 ， 
自然 要 报错 ， 同 样 先 删除 这 行 代 码 。 此 时 工程 如 图 10.2 所 示 。 





由 况 gen [Generated Javs Files] 
i hndroid 2.2 


GD mues 

9 Mndroi Manifest. xnl 
default. properties 
[2] proguard cfe 


图 10.2 Myfilemanager 工程 目录 


10.2 视 图 类 


对 在 UI 显示 界面 中 需要 使 用 到 的 图 片 资源 进行 收集 准备 后 ， 我 们 需要 在 界面 中 使 用 
到 这 些 资源 。 对 于 界面 中 的 所 有 显示 视图 类 ， 分 别 实现 如 下 。 


10.2.1 项 视图 


既然 我 们 想 使 用 类 似 ListView 控件 来 显示 文件 夹 中 的 文件 , 我 们 可 以 不 仿 先 把 每 一 个 
Item 中 的 类 似 TextView 和 类 似 ImageView 做 成 一 个 类 ， 我 们 在 src 文件 夹 中 添加 
Myimagetext.java 文件 ， 代 码 如 下 : 


package com.L.filemanagertest; 
import android.graphics.drawable.Drawable; 


public class Myimagetext implements Comparable<Myimagetext>{ 


private String mText = ""; // 保 存 文件 名 

private Drawable mIcon; // 保 存 图 片 

private boolean mSelectable = true; // 选 择 标识 
// 构 造 方 法 


public Myimagetext (String text, Drawable bullet) { 
mIcon = bullet; 
mText = text? 
} 
// 判 断 是 否 选择 


public boolean isSelectable() { 
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return mSelectable; 


} 


// 修 改选 择 状态 
public void setSelectable (boolean selectable) { 
mSelectable = selectable; 
} 
// 获 取 文件 名 
public String getText() { 
return mText; 
} 
// 设 置 文件 名 
public void setText (String text) { 
mText = text; 
} 
// 设 置 图 片 
public void setIcon (Drawable icon) { 
mIcon = icon; 
} 
// 获 取 图 片 
public Drawable getIcon() { 
return mIcon; 
} 
Q@Override 
public int compareTo (Myimagetext other) { // 实 现 匹 配方 法 


if(this.mText != null) 

return this.mText.compareTo (other.getText()); // 匹 配 文件 名 
else 

throw new IllegalArgumentException(); // 抛 出 异常 


以 上 代码 中 ， 我 们 声明 了 一 个 名 为 Myimagetext 的 类 ， 它 实现 了 将 一 项 中 的 文件 类 型 

图 片 和 文件 名 称 对 应 起 来 ， 并 且 能 够 响应 本 项 是 否 被 选中 。 我 们 注意 到 Myimagetext 实现 
了 Comparable 接口 ， 在 Java 中 实现 Comparable 接口 ， 就 要 求实 现 Comparable 接口 的 
compareTo 接口 , Myimagetext 比较 的 就 是 另 一 个 Myimagetext 对 象 , 在 compareTo 函数 中 ， 
我 们 发 现 传 入 的 就 是 另 一 个 Myimagetext 对 象 。 

GOverride 

public int compareTo (MYyimagetext other) { 

if(this.mText != null) 
return this.mText.compareTo (other.getText ()); 


else 
throw new IllegalArgumentException(); 








上 


这 段 代 码 的 含义 是 只 要 本 对 象 中 的 mText 字段 不 为 空 ,那么 就 和 另外 一 个 Myimagetext 
对 象 比较 它们 的 mText 字 段 , 否则 就 抛 出 非法 参数 异常 ,其 他 代码 public Myimagetext(String 
text，Drawable bulleb 是 构造 函数 ， 剩 下 的 函数 都 是 用 来 设置 或 获取 Drawable mIcon 域 和 
String mText 域 。 


10.2.2 文件 配置 


之 后 我 们 在 values 文件 夹 中 新 加 一 个 和 epostfix.xml 的 文件 , 主要 用 来 列举 常见 的 文件 
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类 型 有 哪些 ， 代 码 如 下 : 


<?xm] version="1.0" encoding="utf-8"?> 
<resources> 
<array name="fileEndingImage"> 
<item>.png</item> 
<item>.gif</item> 
<item>.jpg</item> 
<item>.jpeg</item> 
<item> .bmp</item> 
</array> 
<array name="fileEndingAudio"> 
<item>.mp3</item> 
<item>.wav</item> 
<item>.o0gg</item> 
<item>.midi</item> 
</array> 
<array name="fileEndingPackage"> 
<item>.jar</item> 
<item>.zip</item> 
<item>.rar</item> 
<item>.gz</item> 
</array> 
<array name="fileEndingWebText"> 
<item>.htm</item> 
<item>.html</item> 
<item> .php</item> 
</array> 
</resources> 


以 上 代码 定义 了 一 些 不 同 的 数组 ,其 中 图 片 文件 可 能 会 是 png、jpg、gif、 bmp 等 类 型 ， 
音频 文件 可 能 有 mp3、wav、ogg、midi 等 类 型 ， 而 压缩 类 文件 则 包括 jar、zip、rar 或 者 gz 
等 类 型 ， 最 后 网 络 类 型 文本 则 可 能 是 htm、html 或 php 格式 。 

我 们 再 将 默认 生成 的 string.xml 文件 修改 如 下 : 

<?xml version="1.0" encoding="utf-8"?> 

<resources> 

<string name="app name"> 文 件 管理 器 </string> 


<string name="up one level">..</string> 
<string name="current dir">.</string> 


</resources> 

上 面 代码 定义 了 本 程序 的 名 称 ， 并 且 定 义 了 父 目 录 显 示 为 a 
“..”， 而 本 级 目录 显示 为 “.”， 这 里 借鉴 了 Unix 中 表示 目录 四 filepostfix. xnl 
的 方法 。 此 时 values 文件 夹 应 如 图 10.3 所 示 。 ! 上 strings. xml 
10.2.3 ”适配器 图 10.3 values 文件 夹 


然后 我 们 在 src 文件 夹 中 再 添加 一 个 名 为 MyListAdapter.java 的 文件 , 作用 如 前 面 几 章 
所 述 ， 是 用 来 实现 我 们 自己 的 适配器 来 显示 每 一 项 ， 代 码 如 下 : 


01 public class MyListAdapter extends BaseAdapter { 
02 private Context mContext; 
03 private List<Myimagetext> mItems = new ArrayList<Myimagetext>(); 
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04 “// 构 造 函数 
05 public MyListAdapter (Context context) { 
06 mContext = context; 
07 | 
08 
09 “// 一 系列 的 设置 和 获取 函数 
10 public void addItem (Myimagetext it) { mItems.add(it); }// 添 加 方法 
直下 public void setListItems (List<Myimagetext> lit) { mItems = lit; } 
// 设 置 方法 
2 public int getCount () { return mItems.size(); } // 获 取 总 数 
13 public Object getItem(int position) { returnmItems .get (position); } 
// 获 取 指 定 行 
14 public boolean areAllItemsSelectable() { return false; } 
// 是 否 选 择 全 部 
是 5 public boolean isSelectable(int position) { 
16 return mItems .get (Position) .isSelectable () // 指 定 行 是 否 选择 
浊 尖 } 
18 public long getItemId (int position) { 
19 return position; // 获 取 位 置 
20 } 
22 ”// 重 点 代码 ， 显 示 图 像 
24 Public View getView (int position,View convertView, ViewGroup parent){ 
EA MyView btv; 
26 if (convertView == null) { 
公 h btv = new MyView (mContext, mItems.get (position)); 
// 实 现 显 示 视 图 
28 } else { 
29 btv = (MyView) convertView; 
30 btv.setText (mItems .get (position) .getText () ) ;// 设 置 显示 文件 名 
el btv.setIcon (mItems .get (position) .getIcon() ) ;// 设 置 显示 图 像 
32 } 
33 return btv; 
34 } 
25 


以 上 代码 中 ， 类 MyListAdapter 中 私有 变量 就 是 之 前 我 们 写 好 的 一 组 Myimagetext 对 
象 。MyListAdapter 函数 是 构造 函数 ，getView 函数 是 我 们 自己 实现 BaseAdapter 中 的 接口 ， 
首先 声明 了 一 个 MyView 的 变量 ，MyView 是 我 们 接 下 来 要 实现 的 一 个 View 类 ， 采 用 代 
码 布局 ， 用 来 分 行 显示 文件 名 和 文件 类 型 。btv.setText(mItems.get(position).getTextO) 和 
btv.setIcon(mItems.get(position).getIcon()) 方 法 是 分 别 显示 文件 名 和 该 文件 类 型 对 应 的 图 片 。 


10.2.4 


显示 视图 


我 们 再 新 建 一 个 名 为 MyView.java 的 文件 来 完成 我 们 自己 的 MyView， 代 码 如 下 : 


01 public class MyView extends LinearLayout { // 基 础 线性 布局 

02 private TextView mText; // 定 义 显示 文件 名 视图 

03 private ImageView mIcon; // 定 义 显示 图 像 视图 

04 

05 Public MyView (Context context, Myimagetext alconifiedText) { 
// 构 造 函数 

06 super (Context) 

07 this .setOrientati on (HORIZONTRAL) ; // 设 置 布局 方向 

08 mIcon = new ImageView (context); // 实 例 化 图 像 视图 
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09 mIcon.setImageDrawable (alconifiedText .getIcon()); 
// 设 置 显示 图 像 
10 // 距 离 右边 5px 
六 mIcon.setPadding (0, 2, 5, 0); 
12 // 采 用 线性 布局 
13 addView (mIcon, new LinearLayout .LayoutParams ( 
14 LayoutParams .WRAP CONTENT, LayoutParams.WRAP CONTENT)); 
15 mText = new TextView(context); 
16 mText .setText (aIconifiedText.getText());  // 设 置 显示 内 容 
pg addView (mText, new LinearLayout.LayoutParams ( 
18 LayoutParams .WRAP CONTENT, LayoutParams .WRAP CONTENT)); 
// 添 加 视图 控件 
49 } 
20 
21 public void setText (String words) { // 设 置 显示 内 容 
权 2 mText .setText (words) 
23 } 
24 
25 public void setIcon (Drawable bullet) { // 设 置 图 像 
26 mIcon.setImageDrawable (bullet) : 
27 } 
28 } 


我 们 来 看 一 下 以 上 代码 中 的 重点 ，MyView 这 个 类 是 继承 自 LinearLayout 的 ， 也 就 是 
线性 布局 。 自 己 的 私有 变量 为 TextView mText 和 ImageView mIcon， 这 也 进一步 验证 了 我 
们 之 前 的 假设 ， 每 一 项 的 确 是 需要 TextView 来 显示 文件 名 称 、 用 ImageView 来 显示 文件 
类 型 。 

在 MyView(Context context， Myimagetext alconifiedText) 构 造 函 数 中 ， 首 先 在 单个 
Myimagetext 对 象 中 取出 一 张 图 片 ， 然 后 设置 图 片 距离 边缘 的 距离 ， 通 过 代码 
mlcon.setPadding(0, 2, 5, 0) 来 设置 距离 右边 Spx、 距离 顶端 2px。 代码 addView(mIcon， new 
LinearLayout.LayoutParams(LayoutParams.WRAP CONTENT, LayoutParams.WRAP CONT 
ENT)) 是 显示 第 一 张 图 片 ， 并 采用 线性 布局 ， 并 且 每 一 项 的 显示 都 是 高 度 和 宽度 都 是 恰好 
包 住 了 需要 显示 的 内 容 ， 这 样 每 项 的 高 度 由 于 字体 和 图 片 的 大 小 一 样 而 保持 一 样 ， 宽 度 由 
于 文件 名 长 度 的 不 同 而 不 同 。 之 后 的 代码 重复 了 获取 图 片 和 显示 剩余 项 的 操作 ， 这 样 写 的 
目的 在 于 , 每 打开 一 个 文件 夹 的 时 候 , 顶端 第 一 项 总 是 显示 当前 目录 , 也 就 是 “.”。setText 
和 setIcon 是 设置 文字 和 图 片 的 函数 。 


ap 


10.3 文件 管理 


最 后 我 们 来 完成 MyfilemanagerActivity.java 这 个 类 ， 主 要 是 添加 遍历 方法 和 一 系列 的 导 
航 方法 〈 例 如 返回 和 前 进 等 ) ， 以 及 识别 文件 后 绥 的 方法 。 在 这 里 ， 我 们 讲解 重点 的 代码 。 





10.3.1 遍历 根 目录 


在 视图 创建 时 ， 其 构造 函数 实现 如 下 : 
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下 public void onCreate (Bundle savedInstanceState) 

02 { 

03 super.onCreate (savedInstanceState) 7 

04 setTheme (android.R.style.Theme Black) // 设 置 风格 

05 browseToRoot (); // 调 用 遍历 根 目录 的 方法 
06 this .setSelection(0) 7 

07 } 

08 // 遍 历 根 目录 的 方法 

09 private void browseToRoot () { 

10 browseTo (new File("/")); // 调 用 添加 上 一 级 目录 的 方法 
bs: 


其 中 , 先 设置 了 背景 颜色 , 然后 调用 browseToRootO 开 始 遍历 根 目录 , 我 们 都 知道 linux 
系统 中 根 目录 是 “/”。 
Private void upOneLevel (){ 


if (this.currentDirectory.getParent () != null) 
this .browseTo (this.currentDirectory.getParentFile()); 


10.3.2 上层 目录 


函数 browseTo 0 是 用 来 返回 一 级 目录 ， 如 果 父 级 目录 不 为 空 ， 则 遍历 父 级 目录 。 
private void browseTo (final File aDirectory){ 
// 在 标题 中 显示 全 路 径 
if (this.displayMode == DISPLAYMODE .RELATIVE) // 设 置 显示 模式 
this .setTitle (aDirectory.getAbsolutePath() + " :: "+ 
getstring(R.string.app name)); // 设 置 标题 
if (aDirectory.isDirectory()){ // 判 断 父 级 目录 是 否 为 文件 夹 
this .currentDirectory = aDirectory;// 保 存 其 父 级 目录 为 当前 目录 
fill (aDirectory.1listFiles()); // 调 用 列 出 当前 目录 中 文件 方法 


}elsef{ 
// 创 建 警告 提示 杠 
new AlertDialog.Builder (this) .setTitle(" 提 示 ") 
.SetMessage (" 不 支持 文件 打开 操作 ! ") 
.create () .show (); // 父 级 目录 为 空 ， 给 出 提示 


| 
这 个 函数 是 用 来 凯 历 一 个 指定 的 目录 ， 将 指定 目录 中 所 有 的 文件 遍历 出 来 。 在 这 个 例 
子 中 我 们 限于 篇 幅 的 原因 ， 并 不 支持 打开 文件 操作 ， 其 实 可 以 使 用 Intent 调用 系统 的 程序 
来 打开 特定 的 文件 类 型 ， 或 者 有 心 的 读者 可 以 自己 完善 打开 操作 。 














10.3.3 ”当前 目录 


使 用 方法 fl(aDirectory.listFiles0) 来 列举 当前 目录 中 的 所 有 文件 , 当然 需要 先 通过 代码 
站 (aDirectory.isDirectory()) 来 判断 是 不 是 文件 夹 。 具 体 实现 如 下 : 


01 private void fill(File[] files) { 
02 this.directoryEntries.clear(); 
03 
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// 添 加 当前 目录 
this.directoryEntries.add (new Myimagetext (getString (R.string. 
current dir), 

getResources () .getDrawable (R.drawable.folder))); 


// 添 加 父 类 目录 
if(this.currentDirectory.getParent() != null) 
this.directoryEntries.add (new Myimagetext (getString(R.string. 
up one level), 
getResources () .getDrawable (R.drawable.uponelevel))); 


Drawable currentIcon = null; 


for (File currentFile : files){ // 遍 历 目录 中 的 所 有 文件 
if (currentFile.isDirectory()) { // 为 文件 夹 时 
currentIcon = getResources () .getDrawable (R.drawable. 
folder); // 显 示 文件 夹 图 标 
}else{ 
String fileName = currentFile.getName();  // 获 取 文 件 名 
// 通 过 定义 好 的 xml 文件 来 判断 文件 图 标 


if(checkEndsWithInStringRArray (fileName, getResources(). 
getSstringArray (R.array.fileEndingImage))){ 
// 图 像 文件 
currentIcon = getResources () .getDrawable (R.drawable.image); 
}else if(checkEndsWithInStringArray (fileName, getResources () . 
getstringArray (R.array.fileEndingWebText))){ 
//web 文件 
currentIcon = getResources () .getDrawable (R.drawable. 
webtext); 
}else if(checkEndsWithInStringRrray (fileName, getResources () . 


getstringArray (R.array.fileEndingPackage))){ 

// 上 压缩 包 文件 
currentIcon = getResources () .getDrawable (R.drawable. 
Packed) 

}else if(checkEndsWithInStringRrray (fileName，getResources () . 
getstringArray (R.array.fileEndingAudio))){ 


// 音 视频 文件 
currentIcon = getResources () .getDrawable (R.drawable. 
audio); 

}else{ 
currentIcon = getResources () .getDrawable (R.drawable.text); 
// 文 本 文件 
} 
switch (this.displayMode) { // 显 示 类 型 
case ABSOLUTE: // 绝 对 路 径 
this.directoryEntries.add (new Myimagetext (currentFile. 
getPath(), currentIcon)); 
break; 
case RELATIVE: // 相 对 路 径 
int currentPathStringLenght = this.currentDirectory. 
getAbsolutePath() .length (); 
this.directoryEntries.add (new Myimagetext (currentFile. 
getAbsolutePath () - 
substring (CurrentPathStringLenght) ，currentIcon) ) 
break; 
} 
} 
Collections.sort (this.directoryEntries); // 调 用 排序 方法 
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48 
49 
50 
51 
52 


MyListAdapter itla = new MyListAdapter (this); // 设 置 数据 适配器 
itla.setListItems (this.directoryEntries); 
this.setListAdapter (itla); 

} 


其 中 ，04 一 11 行 ， 在 列举 当前 目录 前 先 添加 当前 目录 “.”、 父 级 目录 “..” 和 它们 对 
应 的 图 片 ， 都 是 folder 类 型 ; 

14 一 35 行 ， 通 过 for 循环 开始 遍历 文件 ， 如 果 是 文件 夹 则 添加 folder 图 片 ， 然 后 开始 
判断 当前 目录 中 文件 类 型 是 哪些 ， 之 前 我 们 通过 filepostfix.xml 这 个 文件 来 列举 了 文件 类 
型 ， 若 是 属于 这 个 xml 中 的 类 型 ， 将 会 被 加 上 对 应 图 片 显 示 出 来 ; 

36 一 46 行 ， 判 断 是 相对 路 径 还 是 绝对 路 径 模式 ， 再 分 别 显示 出 来 ; 

47 一 5$1 行 ， 对 文件 夹 内 的 文件 按照 字母 顺序 进行 排队 ， 通 过 代码 Collections.sort(this. 
directoryEntries) 来 实现 ， 并 设置 好 适配器 Adapter。 


01 


前 文件 的 后 缀 名 判断 的 代码 如 下 : 


Private boolean checkEndsWithInStringRrray (String checkItsEnd, String 
[] fileEndings){ 
for(String aEnd : fileEndings){ // 遍 历 后 织 名 列表 
if (checkItsEnd.endsWith (aEnd)) 
return true; // 有 匹配 ， 则 返回 true 
} 


return false; 


10.3.4 单 击 选择 


完成 了 基本 的 功能 后 ， 下 面 为 显示 的 每 一 个 文件 添加 单 击 事件 ， 具 体 实现 如 下 : 


01 


02 
03 
04 


05 
06 


07 


08 
09 
10 
了 
2 
13 


14 
ES 


16 
eh 


Protected void onListItemClick(ListView 1, View v, int position, long 
id) { 
super.onListItemClick(l1, v, position, id); 
int selectionRowID = (int) this.getSelectedItemId() ;// 获 取 选 择 项 
String selectedFileString = this.directoryEntries.get(selection 
RowID) .getText (); // 获 取 选 择 文件 
if (selectedFileString.equals(getString(R.string.current dir))) { 
this.browseTo (this.currentDirectory); 
// 如 果 选 择 当前 目录 ， 则 刷新 当前 目录 
} else if(selectedFileString.equals (getString(R.string.uP_one 





level))){ 
this.upOneLevel (); // 选 择 上 一 级 目录 ， 则 返回 上 一 级 目录 
} else { 
File clickedFile = null; 
switch (this.displayMode){ // 判 断 显示 类 型 
case RELATIVE: // 相 对 路 径 
clickedFile = new File(this.currentDirectory.getAbsolu 
tePath () 
+ this.directoryEntries.get (selectionRowID). 
getText ()); // 获 取 全 路 径 
break; 
case ABSOLUTE: // 绝 对 路 径 


clickedFile = new File(this.directoryEntries.get (selec 
tionRowID) .getText () ); // 获 取 路 径 
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18 

9 

20 

21 

22 } 
235 中 


break; 
} 
if(clickedFile != null) 
this.browseTo (clickedFile); // 显 示 该 路 径 下 的 所 有 文件 


其 中 ，02 一 09 行 ， 通 过 判断 单 击 的 项 来 进行 操作 ， 如 果 是 当前 目录 ， 则 刷新 显示 当前 


文件 夹 中 的 内 容 ; 


如 果 是 返回 ， 则 返回 上 一 级 目录 ; 


10 一 19 行 ， 如 果 单 击 的 是 文件 夹 ， 则 根据 相对 路 径 和 绝对 路 径 来 显示 文件 夹 内 容 。 


此 处 我 们 限于 
考 。 完 成 以 上 代码 


在 本 章 中 我 们 综合 使 用 前 面 已 经 








篇 幅 原因 ， 不 实现 对 文件 的 操作 ， 例 如 删除 和 复制 等 ， 读 者 可 以 自行 思 
后 ， 我 们 可 以 运行 一 下 程序 ， 结 果 如 图 10.4 所 示 。 








图 10.4 程序 运行 


10.4 本 章 总结 


绍 过 的 界面 设计 、 本 地 数据 存储 、 本 地 资源 访问 、 


介 的 
图 片 文 件 等 知识 完成 了 文件 管理 器 的 综合 案例 。 在 讲解 基本 开发 技能 的 基础 上 ， 还 讲解 了 
-个 综合 应 用 的 框架 设计 和 实现 思路 。 
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在 如 今 的 互联 网 市 场 ， 社 交 网 络 可 以 说 是 如 日 中 天 ， 新 浪 网 也 凭借 着 新 浪 微 博 成 为 国 
内 的 领头 羊 。 我 们 可 以 随时 随地 将 看 到 的 、 听 到 的 、 想 到 的 事情 写成 一 句 话 或 发 一 张 图 片 ， 
分 享 给 朋友 并 一 起 进行 讨论 。 我 们 还 可 以 关注 朋友 ， 即 时 看 到 朋友 们 发 布 的 信息 并 
评论 。 

对 于 发 布 微 博 的 方式 是 多 种 多 样 的 , 我 们 可 以 通过 网 页 、WAP 网 页 、 手 机 客户 端 等 来 
完成 。 新 浪 微 博 也 推出 了 其 开放 平台 ， 提 供 接口 给 开发 者 使 用 。 在 章 中 ， 我 们 将 利用 新 浪 
微 博 的 开放 平台 来 实现 一 个 我 们 自己 的 Android 客户 端 。 





11.1 开放 平台 的 使 用 


要 使 用 新 浪 微 博 的 开放 平台 必须 先 在 其 开放 平台 中 注册 ， 获 取 开 发 应 用 的 密 钥 。 
11.1.1 应 用 注册 


新 浪 微 博 的 开放 平台 地 址 为 http://open.weibo.com/， 在 该 平台 中 ， 针 对 网 站 和 应 用 分 
别提 供 了 接口 。 我 们 使 用 应 用 接口 来 实现 我 们 自己 的 新 浪 微 博客 户 端 ， 如 图 11.1 所 示 。 


合 新 滨 微 起 - 开放 平台 后 


我 要 开发 应 用 从 





图 11.1 开放 平台 











选择 “我 要 开发 应 用 ”后 。 选 择 “ 创 建 应 用 ”， 在 弹出 窗口 中 ， 选 择 我 们 开发 的 应 用 
类 型 。 我 们 开发 Android 客户 端 ， 选 择 “ 客 户 端 ” 开 发 。 在 创建 新 应 用 中 ， 我 们 需要 填写 
应 用 的 相关 信息 ， 进 行 应 用 程序 的 创建 。 

当 应 用 创建 成 功 后 ， 在 应 用 的 基本 信息 中 ， 我 们 可 以 看 到 新 浪 微 博 开放 平台 提供 给 我 
们 使 用 的 App Key 和 App Secret。 在 使 用 开放 平台 时 ， 开 放 平台 通过 这 两 个 值 来 进行 验证 ， 
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标识 接口 调用 的 来 源 以 及 是 否 允 许 调用 该 平台 的 接口 ,在 代码 中 我 们 需要 使 用 到 这 两 个 值 ， 
如 图 11.2 所 示 。 


应 用 基本 信息 [ea 
应 用 欧 零 Anddroid 
六 用 类 型 ; ”普通 应 用 - 客户 端 
1208646773 


a4a79099835bc76f1d2e047f1403bfb1 
2012-01-31 

空 用 平台 :手机 - Android 
社区 好 友 互动 发 布 帮助 


仿 新 浪 油 博 登录 端 ， 用 于 自我 测试 在 Android 平 台 
上 使 用 基本 的 新 浪 油 博 框架 的 能 力 。 


htpJywelbo corm/2672658802 


图 11.2 应 用 信息 


11.1.2 SDK 使 用 


1. 下 载 SDK 


在 新 浪 微 博 开 放 平 台中 ， 提 供 了 SDK 开发 包 以 及 相关 文档 。 对 于 不 同 的 语言 ， 提 供 

了 对 应 的 SDK 包 。 并 且 针 对 Android 平台 ,开放 平 台 提 供 了 对 应 的 开发 包 ， 不过， 建议 同 

时 下 载 针 对 Java 的 SDK 包 ， 在 其 中 有 最 新 的 接口 使 用 。 针 对 Android 的 SDK 包 下 载 地 址 

为 : http://code.google.com/p/sina-weibo4android/， 如 图 11.3 所 示 。 它 不 仅 提供 了 访问 接口 ， 

还 提供 了 最 简单 的 用 户 认 证 、 微 博信 息 的 获取 测试 实例 。 
@3 sina-weibo4android 


ina-walbodandroid 


ProjoctHome | Douwnloats Wi lssues Source 
Summary Updatoe pooplo 





Ds 新 浪 柚 博 开放 平台 ondroid adk 
Actiity ofl Medium : - 
Project feeds .使 用 时 请 在 Weibo java 中 填写 CONSUMER_KEY 和 CONSUMER_SECRET 分 别 为 在 应 用 申请 中 得 到 的 App Key 和 App Secret. 


Code license 22. 使 用 examples 时 如 果 使 用 getWeiboWilhTohen 方 法 需要 在 Testjara 星 设置 授权 后 的 accesstoken 和 accesstokensecrel 获 到 方 法 可 以 参考 
Apache DAuthAP 





Li 有 辣 题 可 以 在 开放 平台 发 表 新 帖 有 buo 信 息 可 以 反 饿 到 htpJ/sinaur cnjhtQuCu 中 . 如果 曲 新 版 本 有 问题 ， 请 下 载 /evision 3。 近 期 会 更 新 sdk。 
am A 





图 11.3 SDK 包 下 载 
2. 使 用 SDK 


对 于 SDK 包 ， 不仅 提供 了 可 以 直接 使 用 的 jar 包 ， 同 时 也 提供 了 源码 。 我 们 可 以 下 载 
使 用 学 习 其 源码 。 把 SDK 的 源码 工程 导入 到 Eclipse 中 ， 可 以 看 到 在 工程 目录 中 包括 了 开 
放 平台 OAuth 认证 、 网 络 传输 、XML 文件 解析 以 及 新 浪 微 博 相 关 的 信息 获取 ， 如 图 11.4 
所 示 。 
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南 veibo4sndriod 
机 veibokandriod sndriodexanples 
由 [1 AndriodExanple. java 
二 [DN OAuthAetivity. java 
BB 门 OAuthConstant, java 
由 了 veibotandriod exanples 
二 让 veibetandriod http 
veibodandriod org json 
加 册 weibokandriod util 
四 -器 gen [Genersted Jara Files] 
3 Bh ndroid 2.2 
由 Bl Referenced Libraries 


Androi Manifest. xml 
目 hs_err_pida00.log 
License 

下 progurd cfg 

目 project. properties 
日 readne txt 


图 11.4 SDK 工程 目录 


其 中 ， 源 码 中 的 weibo4android 包括 了 使 用 新 浪 微 博 的 基本 底层 框架 ， 包 括 版 本 、 配 
置 、 状 态 记 录 、 监 听 以 及 异常 处 理 等 : 


| 


口 


口 
口 


口 


在 weibo4android.androidexamples 中 ， 可 以 直接 使 用 的 演示 示例 。 在 示例 中 ， 主 要 
完成 了 OAuth 认证 和 微 博信 息 。 

在 weibo4android.examples 中 ， 包 括 了 新 浪 微 博 的 相关 微 博信 息 浏 览 、 发 布 微 博 、 

个 人 资料 、 评 论 私信 等 获取 接口 示例 ， 其 中 大 部 分 和 Java 的 示例 是 相同 的 。 

在 weibo4android.http 中 , 包括 了 进行 网 络 传输 的 接口 封装 , 重点 是 使 用 了 传输 加 密 。 
在 weibo4android.org.json 中 , 包括 了 对 网 络 传输 的 返回 数据 XML 和 JSON 格式 的 
封装 和 解析 。 

在 weibo4android.util 中 ， 只 包括 了 浏览 器 的 使 用 。 





我 们 将 该 项 目 在 模拟 器 中 运行 ， 体 验 SDK 给 我 们 提供 的 示例 效果 。 在 SDK 中 提供 了 
较为 简单 的 UI 界面， 例如 其 登录 授权 界面 如 图 11.5 所 示 。 单 击 GoGo 按钮 后 ， 使 用 浏览 
器 跳 转 到 新 浪 微 博 的 授权 网 页 ， 如 图 11.6 所 示 。 








品 而 全 18:00 





回 http:/apitsina.com.cn/.. 加 


Gewe 


直接 用 新 流 半 处 呈 本 录 未 通过 写 应 用 





图 11.5 ”SDK 登录 授权 图 11.6 授权 网 页 
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在 新 浪 微 博 的 授权 网 页 界面 中 ， 我 们 只 需要 输入 已 经 注册 的 新 浪 微 博 的 账户 和 密码 即 
可 完成 授权 。 当 授权 成 功 后 ， 我 们 可 以 获取 来 自 开 放 平台 的 访问 标识 (Access token) 和 访 
问 密 钥 (Access token secret) ， 如 图 11.7 所 示 。 记 录 这 两 个 标记 ， 用 于 之 后 的 登录 使 用 。 
授权 成 功 后 ， 就 可 以 获取 当前 关注 的 好 友 发 布 的 微 博 ， 如 图 11.8 所 示 。 


一 和 过 主观 33362 

















态 加 多 18:02 


TE] 


显示 FriendTimeline 
数 进行 授权 登录 


weilbosandroid 


图 11.7 授权 完成 图 11.8 获取 微 博 


通过 新 浪 微 博 的 SDK 示例 演示 ， 我 们 可 以 看 出 最 基本 的 微 博 授权 、 查 看 功能 ， 但 是 
它 缺 少 Android 应 用 程序 中 必要 的 UI 图 像 界面 ， 也 没有 对 获取 的 微 博信 息 进行 区 分 处 理 。 

在 这 里 , 我 们 使 用 该 SDK 来 实现 一 个 我 们 自己 的 新 浪 微 博 Android 客户 端 。 我 们 只 要 
使 用 过 网 页 版 的 新 浪 微 博 就 知道 ， 在 微 博 中 我 们 主要 可 以 查看 、 编 辑 自己 的 资料 信息 、 自 
己 的 关注 和 粉丝 等 用 户 资料 ， 查 看 提 到 我 们 自己 的 微 博 、 我 们 发 表 的 评论 、 交 流 的 私信 等 
用 户 信息 ; 查看 全 部 微 博信 息 列表 、 单 条 微 博信 息 及 微 博 的 评论 信息 等 ， 更 重要 的 是 发 表 
微 博 、 发 表 评 论 、 转 发 等 互动 交流 功能 。 

了 解 了 这 些 ， 我 们 就 大 体 明 白 了 在 Android 客户 端 中 ， 我 们 需要 完成 的 功能 。 对 于 这 
些 功能 可 以 分 为 3 大 类 别 ， 分 别 是 用 户 资料 、 用 户 信息 以 及 微 博 相 关 的 主 界面 ， 对 于 这 样 
的 3 大 功能 我 们 可 以 使 用 切换 卡 (TabWidget) 来 进行 整体 的 布局 设计 ， 然 后 再 具体 设计 各 
大 功能 的 界面 。 

另 一 方面 ， 使 用 开放 平台 就 必须 先 要 授权 ， 所 以 还 要 有 授权 用 户 管理 的 功能 。 由 于 在 
开放 平台 中 ， 一 旦 授权 后 ， 就 不 再 需要 用 户 输入 用 户 名 、 密 码 ， 直 接 选择 已 经 授权 的 用 户 
登录 即 可 。 所 以 ， 在 我 们 的 Android 客户 端 中 最 开始 呈现 的 就 应 该 是 授权 管理 。 

这 样 ， 我 们 对 于 客户 端 在 整体 的 框架 上 就 有 了 一 个 基本 的 设计 。 接 下 来 ， 我 们 就 一 步 
一 步 来 实现 这 些 功 能 。 

对 于 整个 应 用 我 们 需要 使 用 到 网 络 以 及 写 铃声 数据 等 ,在 AndroidManifestxml 文件 中 ， 
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申请 权限 如 下 : 


<uses-permission android:name="android.permission.ACCESS NETWORK 


STATE™ /> 


<uses-permission android:name="android.permission.INTERNET" /> 


<uses-permission android:name="android.permission.VIBRATE" /> 


<uses-permission android:name="android.permission.WRITE EXTERNAL 


STORAGE" /> 


11.2 用 户 管 理 


在 用 户 授 权 和 管理 中 ,我 们 需要 完成 添加 用 户 以 及 对 已 
妥 权 用 户 的 删除 ， 所 以 我 们 需要 显示 已 授权 用 户 列 表 和 添 
加 、 删 除 用 户 的 功能 选择 ， 界 面 设 计 如 图 11.9 所 示 。 


11.2.1 用 户 授权 请 求 


在 用 户 管理 中 ， 最 重要 的 就 是 实现 用 户 的 授权 。 用 户 授 
权 是 通过 OAuth 认证 方式 来 完成 的 ， 该 认证 授权 主要 分 为 3 
个 步 又 : 

(1) 获取 未 授权 的 Request Token。 

(2) 获取 用 户 授权 的 Request Token。 

(3) 用 授权 的 Request Token 换取 Access Token。 

在 进行 认证 时 ， 需要 获得 认证 的 地 址 以 及 认证 数据 的 返 
回 。 开 放 平 台 为 了 能 够 获取 认证 请 求 的 来 源 ， 会 通过 Weibo 
类 中 的 CONSUMER _ KEY 和 CONSUMER _SECRET 来 进行 
验证 ， 这 两 个 值 便 是 我 们 在 开放 平台 申请 的 应 用 Key 和 Secret。 具 体 实现 如 下 : 


01 btn addUser.setOnClickListener(new OnClickListener() { 








02 @Override 

03 public void onClick(View v) { 

04 EE (sca 

05 OAuthConstant.initData(); // 初 始 化 OAuthCconstant 类 

06 // 新 浪 微 博 认证 页 面 

07 Weibo weibo = OAuthConst ant.getInstance () .getWeibo () 
// 获 取 Weibo 类 

08 try { 

09 RequestToken requestToken = weibo 

10 -getORuthRequestToken ("ouling://UserList"); 
// 获 取 OAuth 请 求 

11 Uri uri = Uri.parse (requestToken .getAuthenticationURL() 

12 + "gfrom=xweibo"); // 构 造 认证 访问 地 址 

13 OAuthConstant .getInstance() .setRequestToken( 

14 requestToken); // 设 置 请 求 

5 Intent intent = new Intent (OAuthUserList.this, 

16 WebViewActivity.class); // 认 证 地 址 Web 跳 转 意图 


图 11.9 用 户 管理 


hy intent .putExtra("url"，uri.toString());// 设 置 访问 地 址 
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18 OAuthUserList.this.startActivity (intent) ; // 跳 转 
19 } catch (WeiboException e) { 

20 e.printstackTrace (); 

人 21 } 

22 1 


其 中 ，05 行 ，OAuthConstant 类 主要 负责 OAuth 认证 数据 的 保存 和 获取 ， 主 要 管理 了 


RequestToken 类 和 AccessToken 类 。 其 中 RequestToken 类 ， 


主要 用 于 管理 未 授权 的 用 户 请 

















求 ， 如 未 授权 的 服务 地 址 ， AccessToken 类 ， 主 要 管理 已 授权 的 用 户 ， 如 获取 授权 用 户 的 


信息 等 ; 

07 行 ，Weibo 类 是 开放 平台 提供 的 访问 API 接口 类 ， 
主要 负责 与 微 博 相 关 的 操作 。 在 这 里 ， 我 们 仅仅 获取 了 该 
类 对 象 。 该 类 中 的 其 他 方法 ， 我 们 将 在 后 续 开发 使 用 中 进 
行 详细 讲解 ; 

09 一 14 行 ,设置 OAuth 认证 的 访问 地 址 以 及 返 
地 址 ; 

15 一 18 行 ， 启 动 Webview 界面 ， 用 于 用 户 的 认证 。 


加 


数据 





11.2.2 ”认证 网 页 


对 于 认证 的 网 页 ， 可 以 通过 直接 调用 浏览 器 来 访问 完 
成 用 户 认证 ; 我 们 使 用 WebView 来 实现 认证 网 页 的 跳 转 显 
示 。 对 于 WebView， 在 网 络 通信 章节 中 己 进 行 了 详细 的 介 
绍 。 在 使 用 时 ， 特 别 需要 注意 使 用 WebSetting 进行 网 页 设 
置 和 使 用 WebChromeClient 进行 网 页 动作 更 新 。 在 
WebView 中 只 需要 跳 转 到 认证 网 页 即 可 ， 实 现 效果 如 图 
11.10 所 示 。 

具体 实现 代码 如 下 : 

01 override 











I pp 2? 


0 新 浪 微 博 


@ seme 


直接 用 新 浪 油 博 犹 号 登录 未 通过 审核 应 用 





图 11.10 用 户 授权 


02 protected void onCreate (Bundle savedInstanceState) { 


03 super .onCreate (savedInstanceState) 7 

04 requestWindowFeature (Window.EFEATURE PROGRESS); // 设 置 窗口 特色 

05 setContentView (R.layout .web); // 设 置 布局 

06 setTitle ("授权 认证 ") ; // 设 置 标题 

07 

08 webInstance = this; 

09 webView = (WebView) findViewById(R.id.web); // 获 取 WebView 控件 
10 WebSettings webSettings = webView.getSettings () ;// 获 取 WebView 设置 类 
el webSettings.setJavaScriptEnabled (true); // 设 置 支持 JavaScript 
webSettings .setSaveFormData (true) // 保 存 表单 数据 
3 webSettings .setSavePassword (true); // 保 存 密码 

14 webSettings .setSupportZoom (true); // 支 持 缩放 
webSettings .setBuiltInZoomControls (true); // 显 示 缩 放 控件 
16 webSettings -setCacheMode (WebSettings .LORD NO CACHE) ;// 设 置 缓存 

并 到 

18 webView.setOnTouchListener (new OnTouchListener () { // 单 击 处 理 监 听 
1 Q@Override 
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20 
321 
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23 
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25 
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32 
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38 


11.2:3 


public boolean onTouch (View v, MotionEvent event) { 
webView.requestFocus (); 
return false; 


| 
和 运 
Bundle bundle = getIntent () -getExtras () 7 // 获 取 传 递 的 数据 
if (bundle != null && bundle.containsKey("url")) { 
webView.loadUrl]l (bundle .getString ("url1")); // 加 载 地 址 


webView.setWebChromeClient (new WebChromeClient() { // 设 置 控制 
public void onProgressChanged (WebView view, int progress) 
{ // 进 度 条 改变 处 理 方法 
setTitle (" 加 载 中 . .."” + progress + "%"); // 设 置 标题 
setProgress (progress * 100) // 设 置 进度 
if (progress == 100) // 加 载 完 成 
setTitle (R.string.app name); // 设 置 标 题 


]) 7 


认证 返回 数据 存储 


在 WebView 中 输入 已 经 注册 的 微 博 的 登录 名 和 密码 ， 进 行 开 放 平 台 授 权 。 完 成 授权 
后 ， 将 关闭 该 Web 页 面 ， 同 时 我 们 再 次 启动 已 验证 用 户 列 表 并 且 将 WebView 中 携带 的 数 
据 传 递 给 用 户 界面 。 由 于 有 Activity 的 意图 启动 和 数据 ， 在 AndroidManifestxml 文件 中 对 
用 户 列表 的 Activity 声明 如 下 : 


<activity 


android:name=" .OAuth.OAuthUserList" 
android:label="@string/app name" 
android:launchMode="singleTask" 
android:screenOrientation="portrait" > 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<category android:name="android.intent.category .DEFAULT" /> 
<category android:name="android.intent.category .BROWSABLE" /> 
<data 
android:host="UserList" 
android:scheme="ouling" /> 
</intent-filter> 


</activity> 


当 认 证 完成 后 ， 开 放 平 台 会 返回 网 络 地 址 ， 该 地 址 用 于 使 用 授权 的 Request Token 获 
取 访 问 Access Token， 从 而 完成 认证 。 当 再 次 使 用 用 户 列 表 界 面 时 ， 会 调用 onNewItent(O 


方法 ， 
如 下 : 








写 该 方法 ， 在 其 中 实现 认证 的 完成 、 标 记 数 据 的 存储 以 及 界面 的 更 新 。 具 体 实 现 


public void onNewIntent (Intent intent) { // 界 面 再 次 调用 时 
super.onNewIntent (intent); 
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03 Uri uri = intent.getData(); // 获 取 传 递 的 数据 
04 ;4 
05 // 保 存 用 户 认证 后 的 返回 信息 
06 RequestToken requestToken = OAuthConstant.getInstance(). 
getRequestToken (); 
07 AccessToken accessToken = requestToken.getAccessToken (uri 
08 .getQueryParameter ("oauth verifier") ) ;// 获 取 请 求 令 牌 
09 OAuthConstant .getInstance () .setAccessToken (accessToken) : 
// 获 取 OAuth 类 
10 
bE Weibo weibo = OAuthConstant.getInstance() .getWeibo(); 
// 获 取 Weibo 类 
12 weibo. setToken (OAuthConstant .getInstance() .getToken() ， 
本 ORuthConstant.getInstance () .getTokenSecret() ) 
// 设 置 授权 微 博 用 户 
14 
15 User user = weibo.showUser (accessToken.getUserId() + ""); 
// 获 取 用 户 信息 类 
16 accessToken.setScreenName (user.getScreenName () ) 
// 获 取 用 户 名 
| 
18 DBAdapter .getInstance (this) .saveUserToken (accessToken); 
// 保 存 用 户 授权 数据 
3 users = DBAdapter.getInstance (this) .getAllUsersAccess 
Token (); // 获 取 所 有 授权 用 户 
20 userAdapter .notifyDataSetChanged() ;// 通 知 数据 改变 ， 界 面 更 新 
站 } catch (Exception e) { 
22 e.printSstackTrace (); 
23 Toast .makeText (this, "添加 失败 "，Toast .LENGTH LONG) .show () ; 
24 ] 
a 


其 中 ，05 一 09 行 ， 通 过 认证 获取 accessToken 类 ， 主 要 是 pass 


OAnuth token 〈 请 求 令 牌 ) 和 OAuth token_secret ( 令 牌 密 钥 ) ; 


CREE 


11 一 13 行 ， 使 用 开放 平台 SDK， 设 置 Weibo 类 ， 通 过 令 牌 和 
密 钥 可 以 访问 授权 的 用 户 ; 

15 行 ， 获 取 授权 用 户 的 信息 ， 保 存 到 User 类 中 ; 

18 行 ， 保 存 授权 用 户 的 信息 到 本 地 数据 库 中 ， 在 下 次 使 用 客 
户 端 时 可 直接 登录 ; 

19 一 20 行 ， 获 取 当 前 本 地 数据 库 中 保存 的 所 有 用 户 数据 ， 并 
更 新 显示 界面 。 实 现 效果 如 图 11.11 所 示 。 





11.2.4 ”认证 信息 的 存储 图 11.11 成 功 添加 用 户 


对 于 认证 信息 ， 我 们 需要 保存 必需 的 令 牌 以 及 令 牌 密 钥 ， 为 了 方便 使 用 我 们 还 需要 保 
存 用 户 ID 以 及 用 户 名 。 对 于 用 户 认 证 信息 ， 我 们 需要 对 其 实现 添加 、 更 新 以 及 删除 等 























操作 。 
对 于 数据 库 的 操作 ， 我 们 使 用 数据 库 辅 助 类 来 完成 。 在 数据 库 中 其 具体 实现 如 下 : 
01 public static final String DATABASE NAME = "weibo.db"; 
02 public static final int DATABASE VERSION = 1; 
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08 


09 
10 
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Public static final String TABLE NAME = "User Token"; 
public static final String[] TABLE CREATE SQL = "CREATE TABLE 
User Token 
(userID long primary key," + "token text,"+ "tokenSecret text," 
+ "screenName text);", 
// 创 建 表 SQL 语句 
Private class MyDBHelper extends SQLiteOpenHelper { 

// 继 承 实现 数据 库 辅 助 类 
public MyDBHelper (Context context, String name, CursorFactory 
factory, int version) { 

super (context, name, factory, version); 


} 


@Override 
public void onCreate (SQLiteDatabase db) { 
db.execSQL(TABLE CREATE SQL[i]);  // 创 建 用 户 认证 信息 表 


@Override 
public void onUpgrade (SQLiteDatabase db, int oldVersion, int 
newVersion) { 
db.execSQL("DROP TABLE IF EXISTS " + TABLE NAME); 
// 更 新 时 ， 删 除 表 
} 
this.onCreate (db); 


使 用 数据 库 辅助 类 ， 我 们 实现 了 数据 库 以 及 表 的 创建 ， 对 于 表 中 认证 用 户 信息 需要 进 
行 保存 、 修 改 、 删 除 等 操作 ， 由 于 这 些 操作 实现 方法 类 似 ， 对 于 保存 认证 信息 实现 如 下 : 


publi 
Pp 


| 


c class DBAdapter { 
ublic void saveUserToken (AccessToken accessToken) {  // 数 据 库 保存 方法 
db = dbHelper.getWritableDatabase (); 
try { 
db.execSQL ("insert into User Token values(?, ?2, ?2, 2)7", 
new String[] { accessToken.getUserId() + "", 
accessToken.getToken(), 
accessToken.getTokenSecret () ， 
accessToken.getScreenName () }) ;//SQL 添 加 数据 语句 
} catch (Exception e) { 
this.updateUserToken (accessToken); 


} 
db.close(); 


通过 以 上 步骤 ， 我 们 实现 了 添加 用 户 授权 的 功能 ， 通 过 用 户 授权 之 后 ， 我 们 就 可 以 方 
便 地 访问 用 户 数据 ， 实 现 客户 端的 功能 。 


Ts 


对 于 月 


删除 用 户 








面 类 似 ，5 


日 户 的 管理 ， 除 了 添加 用 户 之 外 ， 自 然 少 不 了 用 户 的 删除 。 对 于 删除 用 户 的 功能 ， 


同样 需要 一 个 显示 用 户 的 列表 和 “确定 ”或 “取消 ”的 按钮 选择 。 该 界面 和 前 面 显 示 的 界 


需要 将 其 按钮 的 功能 进行 改变 即 可 ， 实 现 如 图 11.12 所 示 。 


为 了 便于 功能 的 确定 ， 我 们 以 两 种 方式 来 区 分 显示 和 删除 。 在 单 击 “ 删 除 ” 按 钮 时 进 
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行 切换 ， 有 具体 实现 如 下 : 


0 新 浪 赏 请 





图 11.12 删除 用 户 


btn deleteUser.setOnClickListener (new OnClickListener() { 
@Override 
public void onClick(View v) { 
if (mode) { 
handler.sendEmptyMessage (DIS MODE); // 切 换 到 显示 界面 
} else { 
handler.sendEmptyMessage (DELETE MODE); // 切 换 到 删除 界面 
} 
hb 
]) 7 


对 于 UI 界面 的 显示 更 新 ,我们 在 Handler 中 实现 。 当 处 于 用 户 管理 方式 时 ， 按 钮 用 于 
添加 和 删除 用 户 ， 当 处 于 用 户 删除 方式 时 ， 按 钮 用 于 确定 和 取消 。 同 时 ， 两 种 方式 中 的 列 
表 视 图 (ListView) 也 是 不 同 的 ， 需 要 更 新 其 显示 。 在 Handler0 中 具体 实现 如 下 ; 


01 


private Handler handler = new Handler() { 
@Override 
public void handleMessage (Message msg) { 
super.handleMessage (msg); 
switch (msg.what) { 


case DIS MODE: // 显 示 界面 
btn deleteUser.setText ("删除 用 户 "); // 设 置 按钮 提示 显示 
btn_addUser .setText ("添加 用 户 ") ; // 设 置 按钮 提示 显示 
mode = true;// 保 存 模式 
break; 


Case DELETE MODE : 
btn deleteUser.setText ("取消 "); 
btn addUser .setText ("确定 "); 
mode = false; 
isCheck = new boolean[users-size()];// 用 户 是 否 删除 的 状态 列表 
Arrays.fill (isCheck, false); // 默 认 未 选择 用 户 
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了 break; 

18 } 

19 users = DBAdapter .getInstance (OAuthUserList.this) .getAllUsers 
AccessToken(); // 获 取 数 据 

20 userAdapter .notifyDataSetChanged(); // 更 新 显示 数据 

21 } 

22 


其 中 ，06 一 10 行 ， 切 换 为 管理 方式 ; 

11 一 18 行 ， 切 换 为 删除 方式 ; 

19 一 20 行 ， 从 数据 库 中 重新 获取 显示 的 认证 用 户 数据 ， 并 提示 数据 变化 更 新 ListView 
显示 


对 于 自 定义 ListView 的 适 配 显示 ， 我 们 在 前 面 章节 已 经 多 次 使 用 ， 这 里 就 不 再 歼 述 。 
11.3 微 博 主 界面 


实现 了 用 户 管理 的 认证 和 删除 之 后 ， 我 们 就 可 以 使 用 该 认证 的 用 户 来 从 开放 平台 中 获 
取 数 据 ， 实 现 客户 端的 功能 。 


11.3.1 认证 用 户 登 录 


当 用 户 认证 之 后 ， 其 登录 不 再 使 用 其 用 户 名 和 密码 ， 而 是 使 用 从 开放 平台 中 获取 该 认 
证 的 用 户 信 息 。 由 于 在 数据 库 中 保存 了 多 个 认证 用 户 的 信息 ， 当 我 们 选择 某 个 认证 用 户 登 
录 时 ， 需 要 记 住 选择 的 认证 用 户 。 在 这 里 ， 我 们 使 用 SharedPreferences 来 进行 保存 。 在 用 
户 管理 界面 中 ， 单 击 选择 用 户 后 就 保存 该 认证 用 户 并 跳 转 到 微 博 界面 ， 具 体 实现 如 下 : 


01 listView.setOnItemClickListener(new OnItemClickListener() { 


02 @Override 
03 public void onItemClick (AdapterView<?> parent, View view, int 
position, long id) { 

04 if (mode) { 

05 // 选择 认证 用 户 登 录 

06 OAuthConstant .getInstance() .setAccessToken (users.get 

(position)); // 获 取 认 证 用 户 信息 

07 EE 

08 ByteArrayOutputStream byaos = new ByteArrayOutput 
Stream(); 

09 SharedPreferences sp = OAuthUserList.this 

10 -getSharedPreferences ("ouling" ,Context.MODE 

PRIVRATE) : 

11 Editor editor = sp.edit(); 

入 2 ObjectoutputSstream oos = new ObjectOutputstream 
(byaos); 

ke oO0s.writeObject (users.get (position)); // 获 取 登 录用 户 数 据 

14 String s = new String (Base64.encodeBase64 (byaos .toByte 
Array())); // 加 密 数 据 

LS: editor.putString("accessToken", s); 

// 保 存 到 SharedPreferences 
16 editor.commit(); // 修 改 提 交 
ek } catch (IOException e) { 
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18 e.printstackTrace (); 

19 Toast .makeText (OAuthUserList.this, "保存 token 失败 "， 
1000) .show(); 

20 } 

21 

22 /7 跳 转 到 微 博 用 户 界面 

23 startActivity (new Intent (OAuthUserList.this, MainActivity. 

class)); 

2 } 

26 } 

> 


11.3.2 主 界 面 设计 


我 们 已 经 分 析 过 ， 在 微 博 中 可 以 分 为 3 大 类 功能 ， 这 3 大 功能 彼此 之 间 没 有 较 强 的 关 
联 性 ， 可 以 独立 地 使 用 切换 卡 布局 来 实现 。 每 一 个 选项 卡 对 应 一 类 功能 。 其 中 ， 在 首页 界 
面 中 主要 针对 与 微 博 相 关 的 功能 ， 作 为 默认 的 界面 ， 在 信息 界面 中 主要 处 理 用 户 的 评论 、 
私信 等 信息 ; 在 资料 界面 中 处 理 用 户 的 关注 、 粉 丝 等 资料 信息 。 整 体 效 果 如 图 11.13 所 示 。 











图 11.13 功能 布局 


对 于 切换 卡 布局 (TabHost) ， 只 需要 一 个 布局 框架 (FrameLayout) 和 一 个 选项 卡 
(TabWidget) 即 可 ， 在 XML 布局 文件 中 实现 如 下 : 


<TabHost xmlns:android="http://schemas .android.com/apk/res/android" 
android:id="@android:id/tabhost" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:orientation="vertical" > 
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<RelativeLayout 


android:layout width="fil1 Parent" 





android:layout height="fill parent"> 
<FrameLayout android:id="@android:id/tabcontent" 





android:layout width="fill Parent" 

android:layout height="fill parent" 

android:layout above="@android:id/tabs" /> 

<TabWidget 
android:id="@android:id/tabs" 
android:layout width="fill parent" 
android:layout height="wrap Content" 
android:layout alignParentBottom="true"/> 
</RelativeLayout> 
</TabHost> 


实现 了 布局 文件 之 后 ， 在 代码 中 具体 实现 每 一 个 选项 卡 的 添加 。 为 了 区 别 当 前 选中 的 
选项 卡 ， 我 们 针 对 选项 卡 的 不 司 状态 进行 不 同 的 背景 设置 。 有 具体 实现 如 下 : 
01 public class MainActivity extends TabActivity implements TabContent 


Factory{ 

02 // 初 始 化 切换 布局 

03 private void initTab() { 

04 setContentView(R.layout.tabactivity) ; // 设 置 布局 

05 tabHost = this.getTabHost(); // 获 取 整 体 布局 框架 

06 tabHost. setBackgroundResource (R.drawable.bg) : 

07 

08 TabSpec tsl = tabHost.newTabSpec ("HOME") .setIndicator ("首页 "); 
// 设 置 首页 选项 卡 

09 tsl.setContent (this); 

10 tabHost.addTab (ts1); // 添 加 到 整体 布局 

11 

12 TabSpec ts2 = tabHost.newTabSpec ("MSG") .setIndicator ("消息 ") 

13 .SetContent (new Intent (this, InfoActivity.class)); 
// 设 置 消息 选项 卡 

14 tabHost .addTab (ts2) ; // 添 加 到 整体 布局 

15. 

16 TabSpec ts3 = tabHost.newTabSpec("INFO") .setIndicator ("资料 ") 

ly .SetContent (new Intent (this, UserInfo.class)); 
// 设 置 用 户 资料 选项 卡 

18 tabHost .addTab (ts3); // 添 加 到 整体 布局 

19 

20 // 切 换 改变 时 

之 和 TabWidget widget = tabHost.getTabWidget(); 

2 了 

23 View view = widget.getChildAt (i); // 遍 历 获取 选项 卡 视图 

24 view.setBackgroundResource (R.drawable.widget btn); 

2 final int index = i; 

26 View.setOnClickListener (new OnClickListener() { 

pe Q@Override 

28 public void onClick(View v) { 

29 PreIndex = tabHost.getCurrentTab(); 
// 获 取 选 择 的 选项 卡 

30 if (tabHost .getCurrentTab () == index) { 
// 如 果 选 择 已 选中 项 , 则 更 新 

名 下 autoGetMoreListView.setSelection(1); 

32 } else { 

33 tabHost .setCurrentTab (index); 
// 跳 转 到 选择 项 
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34 PreIndex = tabHost.getCurrentTab () > 
// 保 存 选中 项 

35 } 

36 } 

人 1); 

38 } 

39 

其 中 ，04 行 ， 设 置 该 TabActivity 的 布局 为 我 们 实现 的 XML 布局; 

08 一 10 行 ， 添 加 一 个 选项 卡 界面 ， 其 标题 为 “首页 ”， 其 显示 界面 在 该 界面 中 完成 ; 

12 一 18 行 ， 类 似 地 添加 了 两 个 选项 卡 ， 标 题 分 别 为 “信息 ”和 “资料 ”。 这 两 个 选项 
卡 的 显示 分 别 跳 转 到 信息 和 资料 界面 中 实现 ; 

21 一 24 行 , 添加 每 一 个 选项 卡 的 背景 动作 。 该 背景 动作 针对 选项 卡 是 否 被 选中 使 用 了 
不 同 的 颜色 进行 区 别 ; 

26 一 37 行 ， 添 加 每 一 个 选项 卡 的 单 击 处 理事 件 ， 用 于 单 击 后 置 于 项 部。 

这 样 ， 我 们 就 实现 了 界面 的 整体 布局 。 有 了 这 样 一 个 整体 布局 之 后 ， 我 们 就 来 对 3 个 
功能 类 进行 实现 。 


11.4 用 户 资 料 


对 于 用 户 的 资料 ， 不必 多 说 就 是 用 户 的 上 昵称、 头像 、 所 在 地 、 博 客 和 介绍 等 基本 信息 ， 
以 及 在 使 用 微 博 过 程 中 所 关注 微 博 、 粉 丝 以 及 自己 发 表 的 微 博 。 在 用 户 资料 界面 需要 显示 
的 就 是 对 这 些 信息 的 描述 。 对 于 其 中 的 关注 、 粉 丝 以 及 微 博 等 信息 还 可 以 查看 其 详情 ， 界 
面 设计 如 图 11.14 所 示 。 


岛 硬 全 21:47 


O 新 浪 赏 博 


站 | [a 


四 川 成 都 
博客 : 无 
介绍 : 无 





| 关注 数 11 





| 粉 经 数 1 








图 11.14 用 户 资料 
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11.4.1 用 户 信息 获取 


在 开放 平台 中 ， 我 们 可 以 通过 用 户 的 id 号 来 获取 用 户 的 资料 信息 。 对 于 用 户 的 这 号， 
在 认证 的 AccessToken 类 中 可 以 获取 , 然后 使 用 Weibo 类 来 对 id 号 进行 获取 用 户 信息 , 具 
体 实现 如 下 : 


cid = OAuthConstant.getInstance() .getAccessToken() .getUserId() + ""; 
Weibo weibo = OAuthConstant.getInstance() .getWeibo(); 
user = weibo.showUser (cid); 


在 SDK 中 的 用 户 类 User 中 ， 记 录 了 用 户 的 详细 信息 ， 主 要 包括 了 : 








private Weibo weibo; //Weibo 类 
private long id; // 用 户 id 号 
private String screenName; // 用 户 昵 称 
private String location; // 用 户 地 区 
private String description; // 用 户 介 绍 
private String profileImageUrl; // 用 户头 像 地 址 
private String url; // 用 户 博客 地 址 
private int followersCount; // 粉 丝 数 
Private int friendsCount; // 关 注 数 
private int statusesCount; // 发 表 微 博 条 数 


在 用 户 类 中 获得 了 这 些 信息 后 ， 只 需要 显示 在 对 应 的 界面 布局 上 即 可 。 对 于 这 种 网 络 
查询 和 界面 UI 的 更 新 ， 我 们 在 Handler 中 实现 ， 具 体 实现 如 下 : 


01 private Handler handler = new Handler() { 


02 @Override 

03 public void handleMessage (Message msg) { 

04 super.handleMessage (msg); 

05 switch (msg.what) { 

06 case InfoHelper.LOADING DATA FAILED:  // 用 户 信息 获取 失败 

07 Toast .makeText (UserInfo.this,，" 获 取信 息 失 败 "，Toast. 
LENGTH_ LONG) .show (); 

08 tv_ failed.setVisibility (View.VISIBLE); 

09 tv_failed.setText ("获取 用 户 资料 失败 ") ; 

10 userinfo waitingView.setVisibility (View.GONE); 

a UserInfo.this.finish(); 

2 break; 

13 case InfoHelper.LOADING DATA COMPLETED: // 信 息 获取 成 功 

14 tv_name.setText (user.getScreenName ()); 

15 tv_decsription.setText ("介绍 : " 

16 + (TextUtils.isEmpty(user.getDescription()) ? 

"无 "” : user.getDescription())); 
了 tv_url.setText (" 博 客 : " 
18 + (user.getURL() != null ? user.getURL() .toSt 
Eing 0 

19 tv location.setText (user.getLocation()); 

20 userinfo pic.setUrl (user.getProfileImageURL(). 
toSstring() ) 

Sl btn follows.setText ("粉丝 数 " + user .getFollowers 
Count 人 

区 btn friends.setText ("关注 数 ”+ user.getFriends 
Count ()); 
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23 


24 


25 
26 
Fi 
28 


btn weibo.setText (" 微 博 数 "” + user. getStatuses 

Count (0 

Toast .makeText (UserInfo.this, " 获取 用 户 资料 完成 " 2 Toasts: 
LENGTH LONG) .show(); 

break; 


其 中 ，06 一 12 行 ， 当 用 户 资料 获取 失败 时 ， 提 示 失 败 返回 主 界面 中 上 一 选项 卡 ; 
13 一 24 行 ， 当 用 户 资料 获取 成 功 时 ， 在 界面 中 显示 该 用 户 资料 信息 。 大 部 分 信息 都 是 
在 User 类 中 直接 提供 的 ， 除 了 用 户头 像 提供 了 网 络 地 址 。 





11.4.2 ”用 户头 像 获取 


1. 网络 图 像 获 取 


在 用 户 信息 中 ， 其 头像 保存 为 网 络 地 址 ， 要 显示 该 图 像 需 要 从 网 络 地 址 中 获取 。 我 们 
使 用 一 个 异步 的 网 络 图 像 获 取 方 法 ， 实 现 如 下 : 


class AsyncViewTask extends AsyncTask<String, Integer, byte[]> { 
@Override 
Protected byte[] doInBackground(String... strings) { 


// 后 台 任务 ， 下 载 头像 图 片 


byte[] data; 
try { 


HttpClient client = new DefaultHttpClient (); 

// 获 取 Httpclient 
HttpGet get = new HttpGet (strings[0]); // 获 取 访 问 地 址 
HttpResponse response = client.execute (get);// 网 络 访问 
HttpEntity entity = response.getEntity(); // 获 取 返 回 数据 





long length = entity.getContentLength () ;// 获 取 返 回 数据 长 度 
if (length <= 0) // 返 回 数据 为 空 


return null; 


InputStream is = entity.getContent (); // 获 取 返 回 数据 流 

ByteArrayOutputStream baos = new ByteRArrayOutputStream() 7 
// 创 建 输出 数据 流 

byte[] buf = new byte[1024]; // 数 据 缓存 区 


dn oh 1 
int count = 0; 
publishProgress (0); // 设 置 进度 条 
boolean isFirst = true; 
while ((ch = is.read(buf)) != -1) { // 获 取 返 回 数据 流 
baos .write (buf，0，ch) // 写 入 缓存 
count += ch; 
publishProgress((int) ((count / (float) length) * (bitm 
aps.length - 1))); // 更 新 进度 条 
if (isFirst && gifNeeded gg& ch > 8) { 
// 判 断 是 否 为 GIF 格式 图 片 
if (ImageItem.isGIF(buf)) { 
handler .sendEmptyMessage (DOWNLOAD GIF); 
isGif = true; 
return null; 
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31 } 

有 2 } 

33 isFirst = false; 

34 } 

35 is.close(); 

36 data = baos.toByteArray (); // 获 取 完 整 的 下 载 数 据 

ky) return data; 

38 } catch (Exception e) { 

39 e.printstackTrace (); 

40 return null; 

41 下 

42 

43 } 

44 

45 @Override 

46 Protected void onProgressUpdate(Integer... progress) { 

47 AsyncImageView.this.setImageBitmap (bitmaps [progress[0]]); 
// 更 新 进度 条 

48 } 

49 

50 @Override 

与 王 Protected void onPostExecute (byte[] result) { 

52 if (result != null) { // 判 断 下 载 数据 是 否 存在 

53 if (AsyncImageView.this.setImageBitmap (result) ) 
// 设 置 显 示 图 片 

54 imageCache .put ("url", new SoftReference<byte[]>(result) ) 
// 保 存 该 下 载 图 片 

55 } else { 

56 if (!isGif && handler != null) { 

57 handler.sendEmptyMessage (DOWNLOAD FAILED) ; // 下 载 失 败 

58 } 

59 } 

60 } 

ch 


-个 异步 任务 主要 由 重 写 4 个 方法 来 实现 ， 其 中 ，onPreExecute0 用 于 执行 后 台 操作 前 界 

面 UI 的 处 理 ，doInBackground(Params...) 用 于 具体 的 后 台 实 现 ，onProgressUpdate(Progress...) 
用 于 后 台 调 用 publishProgress() 方 法 时 的 进度 更 新 ，onPostExecute(Resulb 用 于 在 后 台 执 行 完 成 
后 的 处 理 。 

在 本 图 像 异步 下 载 中 ，03 一 43 行 ， 执 行 图 像 的 网 络 下 载 ， 51 一 60 行 ， 执 行 图 像 数 据 
下 载 完成 后 的 操作 。 当 输入 不 为 空 时 ， 在 视图 中 显示 该 图 像 ， 并 保存 该 图 像 。 保 存 该 图 像 
的 目的 在 于 当 再 次 使 用 该 图 像 时 不 用 再 从 网 络 端 下 载 而 直接 使 用 本 地 已 经 保存 的 图 像 。 

2. 头像 获取 

由 于 我 们 网 络 端 获取 图 像 后 ， 进 行 了 本 地 的 缓存 处 理 ， 所 以 对 于 用 户头 像 提 供 的 网 络 
地 址 ， 我 们 可 以 先进 行 一 次 本 地 匹配 ， 如 果 本 地 已 缓存 则 直接 使 用 本 地 图 像 ， 和 否则 进行 网 
络 下 载 。 该 过 程 具 体 实现 如 下 : 

01 public boolean setUT1 (String url) { 


02 try { 

03 if (URLUtil.isHttpUrl (url)) {// 如 果 为 网 络 地 址 ， 则 连接 URL 下 载 图 片 
04 if (imageCache.containsKey (url)) { // 判 断 是 否 有 本 地 缓存 

05 SoftReference<byte[]> cache = imageCache.get (url); 


// 从 本 地 缓存 中 获取 图 片 
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06 byte[] data = cache.get(); 

07 if (data != null) { 

08 return this.setImageBitmap (data); // 返 回 图 像 数 据 

09 } 

10 } 

a // 网 络 下 载 

4 new AsyncViewTask () .execute (url1); 

3 } else { // 如 果 为 本 地 数据 ， 则 直接 解析 

14 byte[] data = getBytes (new FileInputStream(new File (url))); 
// 从 本 地 URI 资源 获取 图 片 

5 return this.setImageBitmap (data); 

16 F 

Ey } catch (Exception e) { 

18 e-printStackTrace (); 

了 if (handler != null) 1{ 

20 handler.sendEmptyMessage (DOWNLOAD FRILED) 

2 } 

Fd return false; 

23 } 

24 return true; 

5 


其 中 ，04 一 10 行 ， 如 果 本 地 缓存 中 有 该 图 像 ， 则 直接 使 用 本 地 缓存 图 像 ; 

11 一 12 行 ， 如 果 本 地 缓存 没有 该 图 像 ， 则 进行 异步 网 络 下 载 ; 

这 样 ， 我 们 就 完成 了 用 户 基 本 资料 的 显示 ， 显 示 了 用 户 的 基本 资料 以 及 关注 数 、 粉 丝 
数 和 微 博 数 ， 效 果 如 图 11.14 所 示 。 


11.4.3 ”关注 详情 


对 于 关注 详情 即 用 列表 的 方式 显示 用 户 关注 的 所 有 博 主 的 资料 ， 这 些 资 料 同样 是 有 用 
户 的 昵称 、 头 像 、 所 在 地 、 博 客 和 介绍 等 基本 信息 ， 以 及 关注 数 、 粉 丝 数目 以 及 用 户 和 博 
主 之 间 的 关系 ， 如 图 11.15 所 示 。 除 了 显示 这 些 资料 外 ， 我 们 还 可 以 取消 这 种 关注 关系 ， 
并 且 可 以 查看 知道 博 主 的 详细 信息 ， 如 图 11.16 所 示 。 








Sina.com.cmv 
了 清关 二 W2125051145 

先 丝 数 ; 33 

关注 数 : 94 


® 微 博 Android 客 户 端 
注 数 : oo 
互相 关注 


北京 海 深 区 
博客 :无 
介绍 :无 


关注 数 36 微 博 数 245 
插 丝 数 5210953 刷新 


获 到 用 户 资料 完成 


昵称 : 四 川 向 社区 
| 
所 在 地 : 四 川 成 都 


re 博客 地 址 : http://sc.sina. 
om.cnybbsf 
取 清关 注 粉丝 数 : 26048 
关注 数 : 263 
我 已 关注 他 


他 未 关注 我 








图 11.15 关注 详情 图 11.16 关注 的 博 主 详情 
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1. 关注 详情 获取 


在 Weibo 类 中 , 可 以 通过 用 户 id 来 获取 其 所 有 关注 的 博 主 的 用 户 对 象 User 类 , 在 User 
类 中 就 包括 了 需要 显示 的 具体 用 户 资料 ， 获 取 方 法 如 下 : 


private List<User> list = new ArrayList<User>(); 
curUserWapper = weibo.getFriendsStatuses (cid, -1); 
list = curUserWapper.getUsers (); 


2. 详情 显示 


对 于 每 一 个 关注 的 显示 可 以 分 为 一 个 头像 视图 、 一 个 关注 按钮 和 一 个 该 博 主 的 资料 信 
息 ， 对 单个 关注 的 视图 定义 如 下 : 
static class ViewHolder { 
AsyncImageView asyncImageView; 


TextView info; 
Button btn; 





| 


对 于 自 定义 列表 视图 (ListView) ， 需 要 实现 其 适配器 。 在 前 面 章节 中 ， 我 们 进行 了 
多 次 介绍 ， 这 里 就 不 再 袭 述 。 


3. 相互 关注 情况 
在 Weibo 类 中 , 可 以 通过 两 个 用 户 的 id 号 来 判断 这 两 个 用 户 是 否 进行 了 关注 ,方法 是 : 
public JSONObject showFriendships (String source id, String target id) 


使 用 该 方式 来 获取 用 户 和 其 关注 的 博 主 之 间 的 相互 关注 情况 ， 实 现 如 下 : 


01 private List<JSONObject> list relations = new ArrayList<JSONOb 
ject>(); // 初 始 化 关注 关系 列表 
02 private List<User> list = new ArrayList<User>();// 关 注 用 户 信息 列表 
03 
04 protected void getRelation() { // 获 取 相 互 关 注 情况 
05 list relations.clear(); // 清 空 关系 列表 
06 Weibo weibo = OAuthConstant.getInstance() .getWeibo(); 
// 获 取 Weibo 类 
07 for (int index = 0; index < list.size(); index++) { 
// 遍 有 历 用 户 列表 
08 User user = list.get (index); // 获 取 用 户 类 型 
09 EE 4 
10 list relations.add (weibo.showFriendships (OAuth 
Constant .getInstance () - 
11 getAccessToken() .getUserId()+ "", user.get 
TAN Te // 添 加 关注 情况 
2 } catch (WeiboException e) { 
be e.printstackTrace (); 
14 . 
人 1 
16 } 


使 用 Weibo 类 来 获取 相互 之 间 的 关注 关系 后 ， 返 回 到 一 个 JSONObject 类 中 ， 我 们 需 
要 通过 访问 这 个 类 来 判断 两 者 之 间 的 关注 关系 ， 判 断 的 方法 如 下 : 
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JSONObJject object list relations.get (Position) 7 

JSONObJject source object .getJSONObject ("source™"); 

JSONObject target object .getJSONObject ("target"); 

following = Boolean.valueOf (target .getString ("followed by")); 
// 用 户 是 否 关注 博 主 


followed = Boolean.valueOf (source.getString ("followed by")); 
// 博 主 是 否 关 注 用 户 


4. 添加 、 取 消 关注 


User createFriendshipByUserid(String userid) 


其 中 ,参数 userid 是 需要 关注 的 用 户 的 id 号 或 者 上 昵称。 如 果 关 注 成 功 ， 则 返 


户 的 信息 类 User， 否 则 抛 出 异常 。 


对 于 取消 关注 可 以 使 用 方法 : 


User destroyFriendship (String id) 





于 添加 关注 , 在 Weibo 类 中 可 以 使 用 需要 关注 的 用 户 id 或 者 昵称 直接 进行 添加 , 使 
用 方法 : 





回 关注 用 


其 中 ， 参 数 id 是 取消 关注 的 用 户 的 id 号 或 者 昵称 。 对 用 户 的 添加 和 取消 关注 的 具体 
实现 如 下 : 


01 if (following) // 判 断 是 否 关注 
02 holder.btn.setText ("取消 关注 "); // 已 关注 ， 按 钮 显示 “取消 关注 ” 
03 else 
04 holder.btn.setText ("关注 " + sex);  // 示 关注， 按钮 显示 “关注 ” 
05 
06 holder.btn.setOonClickListener (new OnClickListener() { 
07 @Override 
08 public void onClick(View v) { 
09 Weibo weibo = OAuthConstant.getInstance() .getWeibo(); 
// 获 取 Weibo 类 
10 if (holder.btn.getText() .equals ("关注 " + sex)) { 
// 如 果 未 关注 
流泪 tery 4 
hr le’4 Weibo.createFriendshipByUserid(user.getId() + ""); 
// 关 注 
Ya holder.btn.setText ("取消 关注 "); // 更 改 按钮 提示 
14 Toast .makeText (FriendsOrFollowsList.this, "关注 成 
功 !'",1000) .show(); 
了 5 } catch (WeiboException e) { 
16 e.printstackTrace () 7 
17 Toast .makeText (FriendsOrFollowsList.this, "关注 失 
败 !1"，1000) .show(); 
18 } 
19 } else { VE XIE 
20 雹 ye 
站 weibo .destroyFriendship (user.getId() + ""); 
// 取 消 关注 
2 holder.btn.setText ("关注 " + sex);  // 更 改 按 钮 提示 
23 Toast .makeText (FriendsOrFollowsList.this, "取消 关 
注 成 功 !"，1000) - show (); 
24 } catch (WeiboException e) { 
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25 e-printStackTrace (); 

26 Toast .makeText (FriendsOrFollowsList.this, "取消 关 
注 失败 ! ™ 1000) -show(): 

之 } 

28 } 

29 此 

30 }) 


其 中 ，01 一 04 行 ， 根 据 是 否 关 注 ， 设 置 按钮 显示 内 容 ; 
10 一 18 行 ， 设 置 按 钮 处 理事 件 ， 如 果 当 前 是 未 关注 状态 ， 单 击 按钮 则 添加 关注 ; 
19 一 28 行 ,如果 当前 是 关注 状态 ， 单 击 按钮 则 取消 关注 。 实 现 的 效果 如 图 11.17 所 示 。 


[mm 


0 新 浪 贷 博 


上 昵称; 四川 交通 


所 在 地 : 四 川 成 




















图 11.17 取消 关注 


5. 关注 博 主 详情 


在 以 列表 方式 显示 了 所 有 关注 博 主 的 基本 信息 后 ， 我 们 可 以 通过 单 击 列表 项 查看 该 博 
主 的 详细 资料 。 查 看 的 博 主 资料 界面 与 用 户 自身 资料 相同 ， 只 需要 将 博 主 的 ID 号 传递 给 
资料 显示 界面 。 界 面 跳 转 实现 如 下 : 
Intent intent = new Intent (FriendsOrFollowsList.this,UserInfo.class); 
if (position <= list.size()) 


intent .PutExtra("cid"，1ist-get(position - 1) .getId() + ""); 
startActivity(intent); 


11.4.4 粉丝 详情 


对 于 粉丝 详情 的 实现 和 关注 详情 的 实现 思路 是 相同 的 。 首 先 获取 所 有 粉丝 的 详情 ， 然 
后 进行 列表 显示 。 单 击 列表 项 后 显示 该 粉丝 的 资料 信息 。 对 于 所 有 粉丝 详情 的 获取 具体 实 
现 如 下 : 


private List<User> list = new ArrayList<User>(); 
curUserWapper = weibo.getFollowersStatuses (cid, -1); 
list = curUserWapper.getUsers (); 
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显示 粉丝 的 详情 和 显示 关注 的 详情 是 相同 的 ， 就 不 再 袭 述 。 具 体 实现 效果 如 图 11.18 
和 图 11.19 所 示 。 


总 国名 1602 
0 新 浪 获 博 0 新 浪 微 再 


| 


性 别 : 男 四 川 成都 

所 在 地 ; 四 川 成 玫 

博客 地 址 : http://blog 
om.cn/ 





舍 言 : http/blog sna.com. On/U/2 ewe 
介绍 :无 


关注 数 94 微 博 数 324 
共 丝 玛 33 刷新 








图 11.18 粉丝 列表 图 11.19 粉丝 详情 


对 于 发 布 的 微 博 详 情 ， 我 们 在 后 面 的 微 博 相 关 功 能 中 进行 详细 介绍 。 这 样 ， 我 们 就 完 
成 了 用 户 资料 相关 的 功能 。 


11.5 用 户 消 息 


用 户 的 消息 包括 收 到 的 评论 、 发 出 的 评论 以 及 @ 用 户 。 这 样 的 3 类 消息 ， 我 们 采用 和 


主 框架 类 似 的 选项 卡 界 面 设计 。 为 了 不 与 主 框架 界面 的 选项 重 登 而 被 遮挡 ， 将 用 户 消 息 的 
选项 卡 布 局 在 上 方 。 界 面 设计 如 图 11.20 所 示 。 





新 浪 旨 


欧 零 Andr..。 0 
回复 CB 人 条 


回复 忆 后 三 9 评论 - 芳 坪 芝 坪 


原油 博 是 : @ 欧 守 Andmianb 开 语 新 沪 兴 
博 ! 


图 11.20 消息 界面 
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对 于 选项 卡 的 设计 与 实现 和 整体 框架 是 相同 的 ， 就 不 再 袭 述 。 本 节 主要 对 于 收 到 、 发 
出 的 评论 以 及 @ 用 户 信 息 的 获取 和 显示 进行 讲解 。 











11.5.1 获取 信息 


在 Weibo 类 中 ， 提 供 了 获取 评论 信息 的 多 种 方法 ， 对 于 收 到 的 评论 常用 的 方法 是 : 

List<Comment> getCommentsToMe () 

对 于 发 出 的 评论 常用 的 方法 是 : 

List<Comment> getCommentsBYMe () 

这 两 者 返回 的 都 是 评论 的 信息 类 Comment。 我 们 可 以 直接 显示 该 评论 消息 。 对 于 提 到 
用 户 的 信息 ， 常 用 的 获取 方法 是 : 

List<Status> getMentions () 

返回 的 是 微 博 消息 类 Status。 掌 握 了 基本 的 方法 ， 对 于 获取 收 到 的 所 有 评论 ， 有 具体 实 
现 如 下 : 


01 private List<WeiboResponse> commentToMe = new ArrayList<WeiboResponse>(); 
02 Weibo weibo = OAuthConstant.getInstance() .getWeibo(); 

03 commentToMe.clear(); 

04 commentToMe.addAll (weibo.getCommentsToMe()); 











11.5.2 显示 评论 


在 评论 列表 中 ， 我 们 针对 每 一 个 评论 都 显示 其 评论 者 的 上 昵称、 头像 、 评 论 的 时 间 以 及 
评论 的 内 容 。 单 个 评论 视图 可 定义 为 : 

static class ViewHolder { 

AsyncImageView wbicon; 
TextView wbtime; 
TextView wbuser; 
HighLightTextView wbtext; 

} 

其 中 ,视图 wbicon 显示 评论 者 的 头像 ， 视图 wbtime 显示 评论 时 间 ， 视 图 wbuser 显示 
评论 者 昵称 ,视图 wbtext 显示 评论 内 容 。 对 于 评论 内 容 , 我 们 针对 评论 内 容 中 出 现 的 人 名 、 
话题 、 网 址 等 进行 正则 匹配 并 高 亮 显 示 。 

在 Comment 类 中 保存 了 完整 的 评论 信息 ， 常 使 用 的 信息 包括 : 


private Date createdAt; // 评 论 时 间 
private String text; // 评 论 内 容 
private User user; // 评 论 者 资料 
private Comment reply comment; // 评 论 来 源 
private Status status; // 评 论 的 微 博 
private RetweetDetails retweetDetails; // 转 载 的 微 博 


对 于 一 条 评论 信息 ， 我 们 可 以 根据 其 是 否 是 回复 的 评论 、 回 复 的 微 博 以 及 该 微 博 是 否 
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有 转载 来 构造 整个 显示 信息 。 对 于 微 博 中 的 已 有 评论 ， 其 构造 实现 如 下 : 


01 String commentText = comment.getText(); // 获 取 评 论 内 容 

02 if (comment.getReply comment() != null) {// 如 果 该 评判 是 回复 的 已 有 评论 

03 commentText = commentText+ "\n\n 回复 e" 

04 + Comment .getReply comment () .getUser() .getScreenName () 

da 的 评论 二” 

05 + comment .getReply comment () .getText (); 
// 显 示 已 有 评论 

06 

07 if (comment.getStatus () != null)  // 如 果 有 原 微 博 

08 commentText = commentText + "\n\n 原 微 博 是 : @" 

09 + comment .getStatus () .getUser () .getScreenName () 

10 +": "+comment.getStatus() .getText (); 
// 显 示 原 微 博 

了 

12 if (comment.getStatus () .getRetweeted status () != null) 
// 如 果 是 转发 

3 commentText = commentText+ "\n 转自 : @" 

14 + comment .getStatus () .getRetweeted status () . 

getUser () .getScreenName () 
hy + ": " + comment.getStatus () .getRetwee 
ted status () .getText (); 
16 // 获 取 转 发 内 容 
和 } 


其 中 ，01 行 ， 获 取 评论 信息 

02 一 05 行 ， 如 果 评 论 的 是 微 博 中 的 已 有 评论 ， 则 获取 该 已 有 评论 的 信息 ; 
07 一 10 行 ， 如 果 有 原 微 博 ， 则 获取 原 微 博信 息 ; 

12 一 15 行 ， 如 果 原 微 博 是 一 条 转发 微 博 ， 则 获取 转发 微 博 的 信息 。 


11.5.3 ”匹配 高 亮 显示 


对 于 显示 内 容 中 的 人 名 、 话 题 等 需要 进行 正则 匹配 ， 如 果 显 示 的 是 这 些 ， 则 对 人 名 、 
话题 等 高 亮 显示 ， 对 于 这 两 种 的 正则 表达 如 下 : 
// 匹 配 e+ 人 名 
public static final Pattern NAME Pattern = Pattern.-compile( 


"@([\\u4e00-\\u9fa5\\w\\-\\—] {2,30})", Pattern.CASE INSE 
NSITIVE); 


// 匹 配 话题 #. . - 非 

public static final Pattern TOPIC PATTERN = Pattern.compile("#([^\\#I^\\@l|. 

1+)#"); 

有 了 正确 的 正则 表达 后 ， 使 用 正则 匹配 ， 如 果 匹 配 成 功 则 显示 为 蓝 色 。 对 于 话题 ， 具 
体 实现 如 下 : 


SpannableStringBuilder style = new SpannableStringBuilder (text); 





// 设 置 风格 
Matcher topicMatcher = TOPIC PATTERN.matcher (text); 

// 设 置 话题 正则 匹配 表达 式 
while (topicMatcher.find()) { // 如 果 匹 配 为 话题 


style.setSpan (new ForegroundColorSpan (Color .BLUE), 
topicMatcher.start(), topicMatcher.end(), 


FF 


第 11 章 微 博客 户 端 








Spannable.SPAN EXCLUSIVE EXCLUSIVE);  ”// 设 置 蓝 色 显示 
让 


类 似 地 ， 我 们 可 以 用 同样 的 方法 来 实现 昵称 的 匹配 。 














Dre 


11.5.4 ”评论 处 理 


在 查看 了 评论 信息 后 ， 我 们 可 以 对 评论 信息 进行 处 理 ， 
包括 评论 该 消息 、 查 看 原 微 博 、 查 看 评论 者 资料 。 使 用 弹出 
窗口 再 提示 选择 对 应 的 功能 ， 实 现 效 果 如 图 11.21 所 示 。 评论 

在 对 评论 信息 的 3 项 处 理 中 ， 查 看 个 人 资料 功能 可 以 直 因 sws 
接 调用 用 户 资料 中 已 经 实现 的 功能 ， 查 看 原 微 博 功能 ， 我 们 
在 微 博 相 关中 进行 了 详细 介绍 ， 在 这 里 我 们 重点 实现 评论 的 下 A 于 
功能 。 
进行 评论 时 ， 我 们 需要 输入 评论 的 内 容 以 及 是 否 转发 该 
评论 ， 界 面 设计 如 图 11.22 所 示 。 在 微 博 中 进行 评论 ， 使 用 
Weibo 类 中 的 方法 是 : 图 11.21 处 理 评论 


Comment updateComment (String comment, String id, String cid) 


其 中 ， 参 数 comment 是 评论 的 内 容 ， 内 容 不 能 为 空 且 不 超过 140 个 汉字 ;参数 id 是 
评论 的 微 博 消息 的 这 号 ; 参数 cid 是 回复 的 评论 id 号 。 











图 11.22 评论 微 博 








转发 微 博时 ， 使 用 Weibo 类 中 的 方法 : 


Status updateStatus (String status, long inReplyToStatusId) 


其 中 , 参数 status 是 发 布 的 微 博 文本 内 容 , 参数 inReplyToStatusId 是 转发 的 微 博 id 号 。 
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掌握 了 这 两 个 方法 就 能 实现 评论 以 及 转发 微 博 的 功能 ， 有 具体 实现 如 下 : 


01 
02 


new AlertDialog.Builder (context) .setView (layout) 
-setPositiveButton ("确定 ", new DialogInterface.OnClickListener() { 


// 提 示 框 
@Override 
public void onClick(DialogInterface dialog, int which) { 
try { 
Weibo weibo = OAuthConstant.getInstance() .getWeibo(); 
// 获 取 Weibo 类 
String text = editText .getText() .toString () ;// 获 取 评 论 的 输入 内 容 
String msg = ""; 
if (TextUtils.isEmpty (text)) { // 输 入 内 容 为 空 
Toast .makeText (context，" 说 点 什么 吧 ",Toast.LENGTH LONG) . 
show (); // 提 示 输 入 评论 
return; 
if (text.length() > 140) { // 输 入 超过 限制 
Toast .makeText (context，" 要 评论 的 内 容 太 长 了 ", Toast .LENGTH 
LONG) .show (); // 提 示 
return; 
} 
weibo.updateComment (text，weiboID + ""，cid); // 发 表 评论 
msg = "评论 成 功 "; 
if (checkBox.isChecked()) { // 是 否 选择 评论 和 转发 
weibo.updateStatus (text, weiboID); // 转 发 
msg = "评论 且 转 发 成 功 "; 
} 
Toast.makeText (context, msg, Toast.LENGTH LONG) .show(); 
} catch (WeiboException e) { BS 
e.printSstackTrace (); 
Toast .makeText (context， "评论 或 转发 失败 ",Toast .LENGTH LONG) . show (); 
} 
} 
}) .setNegativeButton ("取消 "，new DialogInterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) {} 
}) .setTitle (isComment ? "评论 微 博 " : "转发 微 博 ") .show (); 


其 中 ，07~17 行 ， 判 断 输 入 的 评论 内 容 是 否 为 空 或 超出 限制 ; 

18 一 19 行 ， 发 表 评 论 并 设置 提示 信息 ; 

20 一 23 行 ， 如 果 色 选 转发 微 博 选 项 ， 则 转发 微 博 并 更 改 提示 消息 ; 

25 一 28 行 ， 如 果 评 论 或 转发 失败 ， 则 提示 失败 。 

通过 以 上 步骤 ， 我 们 完成 了 评论 信息 的 处 理 。 主 要 针对 用 户 收 到 的 评论 信息 进行 了 详 


细 讲 解 ， 


完成 。 


类 似 地 可 以 实现 用 户 发 布 的 评论 信息 以 及 @ 用 户 的 信息 的 处 理 ， 就 由 读者 自己 


11.6 微 博 首页 








在 前 面 的 章节 中 ， 我 们 介绍 了 开放 平台 中 的 用 户 资料 、 用 户 消息 等 用 户 使 用 情况 的 获 
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取 和 显示 。 在 本 节 中 ， 我 们 将 介绍 最 重要 的 微 博 首页 。 

在 微 博 首页 中 ,我们 将 显示 用 户 关注 的 所 有 微 博 。 在 显示 列表 中 ， 需 要 显示 微 博 的 发 
布 者 、 发 布 时 间 、 发 布 者 头像 以 及 微 博 内 容 ， 实 现 效 果 如 图 11.23 所 示 。 当 用 户 有 未 读 消 
息 时 ， 在 提示 栏 给 出 提示 ， 效 果 如 图 11.24 所 示 。 


D5 


6 你 有 1 条 未 读 评论 . 


NBA ® 2012:02-06 10-25 


步行 者 主场 104-99 力 克 事 士 。 以 人 逸 待 劳 
的 步行 者 ( 19-7 ) 主场 104-99 战 胜 画 


微 博客 服 @ 2012-02-07 17.09 


# 账 号 安全 # 亲 @， 为 了 保障 您 的 账户 安 
全 ， 微 博客 服 建议 您 绑 定 手机 。 挪 定 手 


机 后 可 以 设置 安全 提醒 和 登录 保护 ， 设 
置 后 当 您 的 账号 出 现任 何 异常 情况 时 就 
会 进行 微 博 短 信 提 柄 。HOLD 住 账户 更 
安全 ! 绑 定 手机 具体 办 法 ; 微 博 首 页 - 

账号 -账号 设置 - 绑 定 手机 页 面 中 进行 设 


置 : http/tcn/adsl3n 。 


川 微 社区 ”多 2012-02.07 1700 
[于 人 千 】 双人 有 中 ,用友 只: 人 


士 (13-11 ) 。 达 伦 - 科 林 森 25 分 4 蓝 
板 5 助攻 ， 罗 伊 - 希 伯 特 17 分 10 蓝 板 , 丹 
16 分 5 篮板 ， 避 士 队 保 罗 - 米 
0 蓝 板 4 助攻 ， 艾 尔 - 杰 弗 
森 16 分 8 篮板 ， 德 文 -哈里 斯 11 分 。 战 
报 : http:WLcn/zOzYb51 


NBA ®@ 2012-02-08 10225 


里 德 加 盟 太 阳 以 来 首次 回 到 密尔沃基 面 
对 老 东 家 雄 鹿 。 里 德 在 雄 谭 打 了 11 个 赛 
季 ,命中 1003 个 3 分 球 排 在 谁 谭 队 史 第 
二 位 ，11554 分 排 在 雄 谭 队 史 


只 有 一 条 路 ,一 条 路 上 多 村 至， 有 钱 
9 第 4 位 。 图 文 直播 地 址 : http2/tcn/ 
~ oO 

权 。 你 品读 出 这 段 话 的 深意 了 么 ? 2 


Ap 四 川 微 社区 宁 201202071535 2-08 





图 11.23 微 博 首 页 图 11.24 未 读 消息 提示 


11.6.1 未 读 消息 

在 登录 到 首页 时 ， 我 们 需要 获取 用 户 的 未 读 消息 ,包括 未 读 评论 、 未 读 @ 用 户 的 微 博 、 
新 的 粉丝 、 未 读 私信 等 消息 。 我 们 可 以 使 用 Weibe 类 中 的 方法 来 获取 未 读 消息 ， 使 用 的 方 
法 如 下 : 


Count getUnread () 


当 获取 成 功 则 返回 Count 类 , 否则 返回 异常 。 在 Count 类 中 主要 包括 未 读 消息 的 条 数 ， 
主要 有 : 


private long comments; // 评 论 
private long dm; // 私 信 
private long mentions; //e 用 户 
Private long followers; // 关 注 者 


对 于 这 些 数据 使 用 Count 类 中 对 应 的 get 方法 来 获取 。 对 于 评论 信息 ， 具 体 实现 如 下 : 


01 public static void unReadNotify (Context context) { 


02 Weibo weibo = OAuthConstant .getInstance () .getWeibo(); 

03 Count unread count; // 定 义 未 读 消息 

04 | 

05 unread count = weibo.getUnread() ; // 获 取 所 有 未 读 消息 

06 NotificationManager notificationManager = (NotificationManager) 
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context 
07 .getSystemService (NOTIFICATION SERVICE) ; // 通 知 栏 管理 器 
08 if (unread count.getComments() != 0) { // 是 否 有 未 读 评论 
09 Notification notification = new Notification(R.drawable. 
image, 
10 "你 有 " + unread count.getComments() +" 条 未 读 评论 ."， 
hl System. currentTimeMillis()): // 构 造 通知 栏 消息 类 
下 之 Intent intent = new Intent (context，InfoActivity.class) 
// 单 击 消息 的 跳 转 
hs intent .putExtra("type", 0); // 设 置 未 读 消息 类 型 
14 PendingIntent contentIntent = PendingIntent.getRctivity( 
ES context, 0, intent, PendingIntent.FLAG UPDATE 
CURRENT); 
16 notification.setLatestEventInfo (context, 
Wh "你 有 " + unread count.getComments () + "条 未 读 评论 ."， 
"",contentIintent); 
18 notification.defaults = Notification.DEFAULT ALL; 
19 notificationManager.notify (UNREAD COMMENT, notification); 
// 提 交通 知 栏 
20 } 
之 } catch (WeiboException e) { 
之 之 e.printSstackTrace (); 
| } 
24 } 


其 中 ，01 一 08 行 ， 获 取 未 读 信息 类 Count， 判 断 其 中 是 否 有 评论 信息 ; 

09 一 11 行 ， 如 果 有 未 读 评论 信息 ， 则 构造 通知 栏 消息 ， 显 示 未 读 评论 的 条 数 ， 效 果 如 
图 11.24 所 示 ; 

对 于 获取 未 读 @ 用 户 的 微 博 、 新 的 粉丝 、 未 读 私信 的 提示 和 实现 获取 未 读 评论 的 提示 
类 似 ， 读 者 可 以 在 此 基础 上 修改 实现 ， 不 再 闭 述 。 


11.6.2 ” 微 博 获取 显示 


对 于 用 户 关注 的 博 主 最 近 发 布 的 微 博 ， 在 Weibo 类 中 提供 了 多 种 方法 ， 常 用 的 是 : 

List<Status> getFriendsTimeline() 

其 中 ， 当 获取 成 功 时 ， 则 返回 最 近 的 微 博 消息 Status 类 列表 ;获取 失败 则 返回 异常 。 
掌握 了 获取 最 近 微 博 的 方法 后 ， 其 具体 实现 如 下 : 


01 private List<WeiboResponse> friendsTimeline = new ArrayList<Weibo 








Response> (); /7 初始化 微 博 信息 
02 Weibo weibo = OAuthConstant.getInstance() .getWeibo(); // 获 取 Weibo 类 
O03 Ery YL 
04 friendsTimeline.addAll]l (weibo.getFriendsTimeline()); 
// 添 加 最 近 的 微 博 消 息 
D5 handler.sendEmptyMessage (InfoHelper.LOADING DATA COMPLETED); 
// 界 面 更 新 
06 } catch (WeiboException e) { 
07 e.printSstackTrace (); 
08 handler.sendEmptyMessage (InfoHelper .LOADING DATA FAILED); 
SEE 


获取 了 需要 显示 的 微 博 内 容 后 ， 对 于 列表 中 的 一 栏 ， 其 中 包括 了 微 博 发 布 者 头像 、 发 
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布 者 昵称 、 发 布 时 间 、 发 布 文字 内 容 以 及 图 片 等 。 视 图 设计 如 下 : 


static class ViewHolder { 


AsyncImageView wbicon; // 头 像 
HighLightTextView wbtext; // 微 博 内 容 
TextView wbtime; // 微 博 发 布 时 间 
TextView wbuser; // 发 布 者 昵称 
ImageView wbimage; // 微 博 图 片 


该 视图 设计 与 显示 用 户 的 消息 的 视图 类 似 ， 视 图 wbicon 显示 评论 者 的 头像 ， 视 图 
wbtime 显示 评论 时 间 ， 视 图 wbuser 显示 评论 者 昵称 ， 视 图 wbtext 显示 微 博 内 容 ， 视 图 
wbimage 显示 微 博 的 图 片 。 使 用 ListView 显示 适配器 来 显示 每 一 条 微 博 的 内 容 ， 其 显示 实 
现 如 下 : 


01 Status status = (Status) curList.get(position); // 获 取 微 博信 息 类 
02 userID = status.getUser() .getId() + ""; // 获 取 发 布 者 id 号 
03 holder.wbicon.setUrl (status.getUser() .getProfileImageURL() .toString 
0); // 设 置 发 布 者 头像 
04 String text = status.getText(); // 获 取 微 博 内 容 
05 if (status.getRetweeted status() != null) // 如 果 是 转载 
06 text = text+ "\n\n 转自 : @"+ status.getRetweeted status () .getUser () 
07 .getscreenName() + " :" + status .getRetweeted status () . 
getText (); // 获 取 原 微 博 内 容 
08 holder.wbtext.setText (text); // 设 置 显示 内 容 
09 holder.wbtime.setText(sdf.format(status.getCreatedAt())); 
// 设 置 发 布 时 间 
10 screenName = status.getUser() .getScreenName(); // 设 置 发 布 者 昵称 
EY 
12 if (status.getRetweeted status() != null) { // 微 博 为 转发 
3 if (!TextUtils- isEmpty (status .getRetweeted status(). 
getThumbnail pic())) 
14 holder .wbimage.setVisibility (View.VISIBLE); 


// 原 微 博 中 有 图 片 ， 则 显示 图 片 
15 } else if (!TextUtils.isEmpty(status.getThumbnail pic())) 


// 微 博 中 是 否 有 图 片 
16 holder.wbimage.setVisibility(View.VISIBLE) ; // 显 示 图 片 


其 中 ，01 行 获取 微 博信 息 类 status; 

02 一 10 行 ， 分 别 从 微 博信 息 中 获取 微 博 发 布 者 头像 、 微 博 内 
容 、 发 布 时 间 以 及 发 布 者 昵称 ; 

11 一 16 行 ， 判 断 微 博 及 其 转发 的 微 博 中 是 否 包含 图 片 ， 如 果 
有 图 片 ， 则 显示 图 片 。 


11.6.3” 微 博 详情 


实现 了 显示 最 近 微 博 列 表 ， 还 需要 查看 每 一 条 微 博 进行 的 详 
情 处 理 ， 例 如 查看 该 微 博 的 评论 以 及 对 该 微 博 的 评论 与 转发 等 。 
单 击 列表 中 的 微 博 后 ， 针 对 该 微 博 进行 详情 处 理 ， 在 界面 上 需要 | Ed 
显示 发 布 者 的 昵称 、 ee 微 博文 字 和 图 片 内 容 、 已 有 评论 信息 
以 及 提供 的 转发 、 评 论 功能 ， 设 计 如 图 11.25 所 示 。 图 11.25 查看 微 博 详情 
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对 于 微 博 的 发 布 者 昵称 、 头 像 、 微 博文 字 和 图 片 等 内 容 ， 我 们 可 以 直接 从 Weibo 类 中 
获取 ， 其 获取 方法 与 在 微 博 显示 列表 中 获取 的 方法 是 相同 的 ， 读 者 可 参照 列表 中 的 方法 实 
现 。 本 小 节 重 点 讲解 已 有 评论 的 获取 和 显示 。 

(1) 评论 的 获取 和 显示 

获取 微 博 中 的 最 近 评 论 ， 使 用 Weibo 类 中 的 方法 : 


List<Comment> getComments (String id) 


其 中 ， 参 数 id 是 微 博 的 id 号 ， 返 回 值 为 评论 信息 类 Comment。 在 本 例 中 ， 获 取 评 论 
的 具体 实现 如 下 : 
private List<Comment> comments = new ArrayList<Comment>(); 


Weibo weibo = OAuthConstant.getInstance() .getWeibo(); 
comments = weibo.getComments (weiboID + "") 7 


在 评论 信息 的 列表 中 ， 我 们 需要 显示 评论 者 的 头像 、 昵 称 以 及 评论 内 容 。 在 界面 设计 
视图 定义 为 : 
static class ViewHolder { 

AsyncImageView asyncImageView; // 评 论 者 头像 

TextView tv name; // 评 论 者 昵称 

HighLightTextView tv text; // 评 论 内 容 


得 


} 


获取 评论 信息 类 Comment 中 具体 的 方法 , 我 们 已 经 在 用 户 信息 相关 章节 中 进行 了 详细 
介绍 ， 使 用 这 些 方法 实现 评论 信息 的 显示 的 代码 如 下 : 


01 holder.asyncImageView.setUrl (comments .get (position) .getUser() 

02 .getProfileImageURL() .toExternalForm() ) ; // 获 取 评 论 者 头像 

03 holder.asyncImageView.setProgressBitmaps (ImageRel .getBitmaps_ 
avatar (ViewActivity.this)); 

04 holder.asyncImageView.setPadding (10，10，10，10); // 设 置 头像 图 片 大 小 

05 

06 holder.tv name.setTextColor(Color.BLUE);  // 设 置 评论 者 昵称 显示 的 颜色 

07 holder.tv name.setText (comments.get (position) .getUser() .getScreen 
Name ()); // 获 取 评论 者 昵称 

08 holder.tv name.setPadding(5, 10, 0, 0); // 设 置 昵称 的 文字 大 小 

09 

10 holder.tv text.setPadding (10，10，10，10); // 设 置 评论 的 文字 大 小 

11 holder.tv text.setGravity (Gravity.CENTER VERTICAL); /71 设置 评论 排版 

12 holder.tv text.setText (comments.get (position) .getText () ) ;// 设 置 评论 内 容 

13 holder.tv text.setTextColor (Color.BLRCK) ; // 设 置 评论 的 文字 颜色 


其 中 ，01 一 04 行 ， 获 取 并 显示 评论 者 的 头像 ; 

05 一 08 行 ， 显 示 评 论 者 的 昵称 ， 为 了 更 明确 ， 文 字 以 蓝 色 显示 ; 

09 一 13 行 ， 显 示 评 论 的 内 容 。 

(2) 转发 与 评论 

查看 了 微 博 以 及 其 评论 后 ， 我 们 可 以 针对 该 微 博 或 已 有 评论 进行 转发 或 评论 。 对 于 评 
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与 转发 的 处 理 ， 我 们 在 用 户 消息 一 节 中 进行 了 讲解 ， 这 里 直接 
调用 评论 弹出 框 即 可 ， 效 果 如 图 11.26 所 示 。 


11.6.4 发 布 微 博 


在 微 博 客户 端 除了 查看 微 博之 外 ， 还 有 另 一 个 重要 的 功能 就 
是 发 布 微 博 。 

在 微 博 首页 ， 我 们 添加 一 个 菜单 按钮 用 于 发 布 微 博 ， 实 现 效 
果 如 图 11.27 所 示 。 在 发 布 微 博 的 主 界面 中 ， 需 要 输入 微 博 的 文 
字 以 及 图 片 等 内 容 ， 界 面 实现 如 图 11.28 所 示 。 图 区 26 评论 微 铺 
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图 11.27 菜单 按钮 图 11.28 发 布 微 博 界面 

在 界面 中 ,最 重要 的 部 分 就 是 发 布 微 博 的 文字 内 容 ， 占 据 了 最 大 一 部 分 。 在 界面 底部 ， 
左边 是 用 于 发 图 片 的 选择 按钮 ， 右 边 是 发 布 按钮 以 及 提示 当前 文字 数 。 

1. 图 片 选 择 

在 图 片 选择 功能 中 ， 我 们 可 以 选择 来 自 手机 相册 中 己 有 的 图 片 ， 也 可 以 进行 拍照 而 获 
得 图 片 。 查 看 相册 和 拍照 都 可 以 通过 调用 系统 程序 来 完成 。 当 然 ， 如 果 对 选择 的 图 片 不 满 
意 也 可 以 进行 删除 。 有 具体 实现 如 下 : 

01 CharSequence[] items = { "手机 相册 "，" 手 机 拍照 "， "清除 照片 ”}; 


// 图 片 来 源 提示 

02 new AlertDialog.Builder (ShareActivity.this) .setTitle ("增加 图 片 ") 

83 -SetItems (items, new DialogInterface.OnClickListener() { 
// 图 片 选择 提示 框 

04 public void onClick (DialogInterface dialog, int item) { 

05 // 手 机 相册 

06 if (item == 0) { 

07 Intent intent = new Intent (Intent.ACTION GET CONTENT); 
// 跳 转 到 获取 SD 卡 内 容 
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} 


intent .setType ("image/*"); // 获 取 内 容 为 图 片 类 型 
startActivityForResult (intent, REQUEST CODE GETIMAGE 
BYSDCARD) ; // 实 现 跳 转 
} 
// 拍 照 


else if (item == 1) { 
Intent intent = new Intent("android.media.-action.IMAGE 
CAPTURE"); // 跳 转 到 获取 拍照 图 片 
String fileName = InfoHelper.getWeiboPath()+ InfoHelper. 
getFileName() + ".jpg"; 
intent .putExtra (MediaStore.EXTRA OUTPUT, Uri.fromFile (new 
File (fileName))); 
startActivityForResult (intent, REQUEST CODE GETIMAGE 


BYCAMERA); 
} else if (item == 2) { // 删 除 图 片 
uploadImage = null; // 设 置 上 传 图 片 为 空 


imageView.setBackgroundDrawable (nul1) ; // 设 置 选择 图 片 为 空 
} 


}) .show(); 


其 中 ，06 一 10 行 ， 实 现 单 击 “ 手 机 相册 ”选项 跳 转 到 相册 ; 
11 一 16 行 ， 实 现 单 击 “ 手 机 拍照 ”选项 跳 转 到 系统 的 拍照 程序 ; 
17 一 20 行 ， 实 现 删除 选择 的 图 片 ， 实 现 效果 如 图 11.29 和 图 11.30 所 示 。 
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图 11.29 增加 图 片 图 11.30 图 片 选中 








2. 图 片 地 址 获取 


当 从 相册 获取 图 片 或 者 拍照 完成 后 ， 会 从 相册 或 者 拍照 界面 返回 图 片 地 址 。 对 于 获取 
从 相册 中 选择 的 图 片 地 址 ， 实 现代 码 如 下 : 


01 protected void onActivityResult(int requestCode int resultCode, Intent 


02 
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data) { 





// 跳 转 返 回 


if (requestCode == REQUEST CODE GETIMAGE BYSDCARD) { 


第 11 章 微 博客 户 端 








// 从 SD 卡 中 获取 图 片 
03 if (resultCode != RESULT OK) { // 获 取 失 败 
04 return; 
05 } 
06 if (data == null) // 返 回 内 容 
07 return; 
08 
09 Uri thisUri = data.getData(); // 获 取 图 片 URI 地 址 
10 String thePath = InfoHelper.getAbsolutePathFromNoStandard 
Uri (thisUri); // 转 化 URI 地址 
un // 如 果 是 标准 URI 
a if (TextUtils.isEmpty(thePath)) { 
得 uploadImage = getAbsoluteImagePath (thisUri);// 获 取 该 URI 地 址 
14 } else { 
15 uploadImage = thePath; // 获 取 标 准 URI 地 址 
16 } 
造 汉 } 
LS 


其 中 ，01 行 ， 重 写 界面 返回 方法 onActivityResult()， 获 取 从 相册 中 选择 图 片 的 地 址 ; 
02 一 07 行 ， 判 断 返回 的 数据 是 否 为 空 ， 为 空 则 返回 退出 ; 
08 一 16 行 ， 如 果 返 回 数据 不 为 空 ， 则 获得 该 地 址 。 


3. 发 布 微 博 
当 完 成 了 微 博 的 文字 内 容 和 图 片 的 选择 之 后 ， 就 需要 向 开放 平台 提交 并 发 布 微 博 。 在 








Weibo 类 中 ， 提 供 了 多 种 发 布 微 博 的 方法 ， 其 中 常用 的 有 : 


Status updateStatus (String status) 
Status uploadStatus (String status, File file) 


其 中 ， 参 数 status 是 文本 信息 。 参 数 file 是 附带 文件 ， 通 常 是 图 片 文件 。 当 发 布 失败 
则 返回 异常 。 在 掌握 了 发 布 微薄 的 方法 后 ， 具 体 的 实现 如 下 : 





ol try { 
02 Weibo weibo = OAuthConstant.getInstance () .getWeibo(); 
// 获 取 Weibo 类 
03 if (weibo == null) { // 获 取 失 败 
04 SharedPreferences sp = getSharedPreferences ("ouling",Context. 
MODE PRIVATE); 
05 String s = sp.getString("accessToken", null); 
// 从 保存 用 户 数据 中 读 取 
06 if (s != null) { 
07 byte[] bytes = Base64.decodeBase64(s.getBytes()); 
// 解 密 保存 数据 
08 ByteArrayInputStream bais = new ByteArrayInputStream 
(bytes); 
09 ObjectInputStream ois = new ObjectInputSstream(bais); 
10 AccessToken accessToken = (AccessToken) ois.readObject () 
// 获 取 访 问 密 钥 
3 if (accessToken != null) 
12 OAuthConstant.getInstance() .setAccessToken(access 
Token); // 重 新 获取 授权 用 户 
3 
14 } 
Ls String msg = contentEditText .getText () .toString(); // 获 取 输 入 内 容 


. 461 . 


实战 Android 应 用 开发 











16 if (msg.getBytes () .length != msg.length()) {// 判 断 编码 是 否 为 UTF-8 

17 msg = URLEncoder.encode (msg，"UTF-8"); // 转 化 编码 方式 

18 1 

二 9 

20 if (TextUtils.isEmpty (uploadImage)) { // 判 断 是 否 有 图 片 

21 weibo.updateStatus (msg); // 没 有 图 片 ， 则 调用 发 布 文字 方法 

2 } else { // 有 图 片 

23 File file = new File(uploadImage); 

24 weibo.uploadStatus (msg, file); // 调 用 发 布 文件 方法 

25 } 

26 handler .sendEmptyMessage (UPDATE SUCCESS); // 通 知 发 布 成 功 

27 } catch (Exception e) { 

28 e.printSstackTrace (); 

29 handler .sendEmptyMessage (UPDATE FAILED); 

S30 

其 中 ，02 一 14 行 ， 获取 Weibo 类 ， 如 果 获 取 该 类 失败 ， 则 从 保存 的 AccessToken 中 重 
写 获取 Weibo 类 ; 


15 一 18 行 ， 判 断 输 入 的 文字 是 否 为 UTF-8 编码 ， 进 行 编码 转换 ; 

20 一 25 行 , 判断 是 否 发 布 图 片 文件 , 采用 不 同 的 发 布 微 博 的 方法 进行 发 布 , 如 图 11.31 
所 示 。 

当 完 成 发 布 后 ， 我 们 可 以 在 已 发 微 博 中 看 到 我 们 刚 发 布 的 微 博 ， 如 图 11.32 所 示 。 
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图 11.31 发 布 微 博 图 11.32 查看 发 布 微 博 


11.7 本 章 总 结 


在 本 章 中 ， 我 们 使 用 新 浪 微 博 的 开发 平台 ， 实 现 了 基本 的 微 博 Android 客户 端 ， 实 现 
了 微 博 中 基本 的 查看 和 发 布 微 博 、 评 论 ， 查 看 用 户 的 详细 资料 等 功能 ， 达 到 了 一 个 基本 客 
户 端的 需求 。 在 实现 该 客户 端的 过 程 中 ， 我 们 使 用 了 界面 UI 设计、 数据 存储 、 网 络 传输 、 
拍照 、 图 像 显 示 等 多 种 技能 。 和 希望 读者 能 在 实现 了 以 上 基本 功能 的 基础 上 ， 还 可 以 完善 其 
细节 以 及 添加 分 享 GPS 地 址 、 分 享 天 气 等 更 多 的 功能 来 实现 自己 的 客户 端 。 
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